notepad++
Автозаполнение и предложение

Основные настройки автозаполнения и предложения

Notepad ++ предоставляет 2 типа функций для автоматического завершения и предложений:

• Автозаполнение, которое считывает открытый файл и предлагает предложение слов и / или функций в файле
• Предложение с аргументами функций (специфичных для языка)

Чтобы включить его, вам нужно изменить настройку.

1. Перейдите в Settings > Preferences... > Auto-completion
2. Установите Enable Auto-completion on each input
3. Выберите тип желаемого завершения:
   • только слова
   • только имя функций
   • оба из них
4. Необязательно, установите флажок « Function parameter hint on input для отображения параметров при вводе имени функции (см. Снимок ниже)

Чтобы использовать его, начните вводить слово или функцию, и после количества символов, которые вы указали, появятся предложения:

Некоторые документы об автозаполнении доступны здесь: http://docs.notepad-plus-plus.org/index.php/Auto_Completion

Настройка предложения языка (подсказка параметра функции)

Параметры подсказки могут быть настроены пользователем, как указано в этой ссылке: http://docs.notepad-plus-plus.org/index.php/Auto_Completion#How_to_create_keyword_auto-completion_definition_files

Как создать файлы определения автозаполнения ключевых слов

Поскольку версия 5.0 Notepad ++ поддерживает так называемые Calltips и ввела новый способ хранения данных автозаполнения. Теперь все хранится в формате XML, что позволяет легко расширить функциональность. Таким образом, данные автозаполнения и calltip объединяются в один файл. Старые текстовые файлы .api больше не используются Notepad ++ и могут быть безопасно удалены, если они есть.

Вы можете выбрать то, что srt автозаполнения вы хотите иметь, из « Settings -> Preferences -> Auto Completion -> Enable Auto-completion на каждом входе: слова из текущего документа, функции с текущего языка или и то, и другое.

Файлы AutoComplete находятся в папке «plugins \ APIs», которые можно найти в папке установки Notepad ++, чаще всего в C:\Program Files\Notepad++ .

Синтаксис файлов AutoComplete прост, но имеет несколько правил, наиболее важно правильный синтаксис и правильная сортировка. Если синтаксис неверен, файл XML не будет загружаться, а автозаполнение будет отключено. Более подробное описание можно найти в разделе «Редактирование файлов автозаполнения» .

Неправильная сортировка (см. Ниже) может привести к тому, что функция автозаполнения будет вести себя неустойчиво, что приведет к сбою определенных слов.

Основной набор символов, используемый для распознавания ключевых слов, состоит из букв (т.е. az , AZ , 0-9 цифр и underscore ). [...]

<?xml version="1.0" encoding="Windows-1252" ?>
<NotepadPlus>
   <AutoComplete language="C++">
       <Environment ignoreCase="no" startFunc="(" stopFunc=")" paramSeparator="," terminal=";" additionalWordChar = "."/>
       <KeyWord name="abs" func="yes">
           <Overload retVal="int" descr="Returns absolute value of given integer">
               <Param name="int number" />
           </Overload>
       </KeyWord>
   </AutoComplete>
</NotepadPlus>

Ниже приведен небольшой пример того, как построен XML-файл. NotepadPlus, AutoComplete и Environment являются одноэлементными элементами, каждый должен присутствовать только один, и все они должны присутствовать для правильности, хотя разрешено удалять элемент <Environment> . По умолчанию все значения будут соответствовать значениям, указанным в приведенном выше примере.

Для ключевых слов, которые не являются функциями, тег ключевого слова автозаполняется и имеет только атрибут name . Чтобы указать ключевое слово, которое можно отобразить в подсказке, добавьте атрибут func со значением yes . В этом случае тег Keyword является узлом и содержит другие теги.

Затем для каждой перегрузки функции должен быть добавлен элемент перегрузки, который определяет поведение и параметры функции. Функция должна иметь по крайней мере одну перегрузку или она не будет отображаться в качестве подсказки. retVal должен присутствовать и задает тип возвращаемого значения, но атрибут descr является обязательным и описывает поведение функций, например комментарий.

Вы можете добавить новые строки в описании, если хотите это сделать. Для каждого параметра, который выполняет функция, может быть добавлен элемент Param . Атрибут name должен присутствовать и указывать тип параметров и / или любое имя параметра.

В элементе AutoComplete вы можете добавить атрибут language но Notepad ++ не используется, вы можете добавить его для полноты, если хотите, и можете взять любую нужную строку.