notepad++
Autouzupełnianie i sugestie

Podstawowe ustawienia autouzupełniania i sugestie

Notepad ++ zapewnia 2 typy funkcji do automatycznego uzupełniania i sugestii:

• Automatyczne uzupełnianie, które odczytuje otwarty plik i zapewnia sugestię słów i / lub funkcji w pliku
• Sugestia z argumentami funkcji (specyficznymi dla języka)

Aby go włączyć, musisz zmienić ustawienie.

1. Przejdź do Settings > Preferences... > Auto-completion
2. Zaznacz Enable Auto-completion on each input
3. Wybierz rodzaj ukończenia, jaki chcesz:
   • tylko słowa
   • tylko nazwa funkcji
   • oboje
4. Opcjonalnie zaznacz Function parameter hint on input aby wyświetlić parametry podczas wpisywania nazwy funkcji (patrz rysunek poniżej)

Aby go użyć, zacznij pisać słowo lub funkcję, a po określonej liczbie znaków pojawią się sugestie:

Niektóre dokumenty dotyczące automatycznego uzupełniania są dostępne tutaj: http://docs.notepad-plus-plus.org/index.php/Auto_Completion

Dostosowanie sugestii języka (podpowiedź do parametru funkcji)

Wskazówki dotyczące parametrów mogą być dostosowane przez użytkownika, jak wskazano w tym linku: http://docs.notepad-plus-plus.org/index.php/Auto_Completion#How_to_create_keyword_auto-completion_definition_files

Jak utworzyć pliki definicji autouzupełniania słów kluczowych

Od wersji 5.0 Notepad ++ obsługuje tak zwane Porady i wprowadził nowy sposób przechowywania danych autouzupełniania. Teraz wszystko jest przechowywane w formacie XML, co pozwala na łatwe rozszerzenie funkcjonalności. W ten sposób dane autouzupełniania i podpowiedzi są łączone w jednym pliku. Starsze pliki zwykłego tekstu .api nie są już używane przez Notepad ++ i można je bezpiecznie usunąć, jeśli są obecne.

Możesz wybrać srt autouzupełniania, które chcesz mieć, w Settings -> Preferences -> Auto Completion -> Enable Auto-completion autouzupełnianie przy każdym wprowadzeniu: słowa z bieżącego dokumentu, funkcje z bieżącego języka lub oba.

Pliki Autouzupełniania znajdują się w folderze „plugins \ APIs”, który znajduje się w folderze instalacyjnym Notepad ++, najczęściej C:\Program Files\Notepad++ .

Składnia plików autouzupełniania jest prosta, ale ma kilka zasad, przede wszystkim poprawną składnię i właściwe sortowanie. Jeśli składnia jest nieprawidłowa, plik XML nie załaduje się, a Autouzupełnianie zostanie wyłączone. Bardziej formalny opis można znaleźć w Edycja plików autouzupełniania .

Nieprawidłowe sortowanie (patrz poniżej) może powodować nieprawidłowe działanie funkcji autouzupełniania, powodując awarię niektórych słów.

Podstawowy zestaw znaków używany do rozpoznawania słów kluczowych składa się z liter (tj. az , AZ , cyfr 0-9 i 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>

Mały przykład budowy pliku XML podano powyżej. NotepadPlus, Autouzupełnianie i Środowisko są elementami singletonowymi, powinien być tylko jeden z nich i wszystkie powinny być obecne dla poprawności, chociaż można usunąć element <Environment> . Spowoduje to, że wszystkie wartości zostaną ustawione domyślnie na wartości podane w powyższym przykładzie.

W przypadku słów kluczowych, które nie są funkcjami, znacznik Keyword jest automatycznie zamykany i ma tylko atrybut name . Aby wskazać, że słowo kluczowe może być wyświetlane w podpowiedzi, dodaj atrybut func o wartości „ yes . W tym przypadku znacznik słowa kluczowego jest węzłem i zawiera inne znaczniki.

Następnie dla każdego przeciążenia funkcji należy dodać element Przeciążenie, który określa zachowanie i parametry funkcji. Funkcja musi mieć co najmniej jedno Przeciążenie, w przeciwnym razie nie będzie wyświetlana jako wskazówka. Atrybut retVal musi być obecny i określa typ zwracanej wartości, ale atrybut descr jest opcjonalny i opisuje zachowanie funkcji, takie jak komentarz.

Jeśli chcesz, możesz dodać nowe linie w opisie. Do każdego parametru pobieranego przez funkcję można dodać element Param . Atrybut name musi być obecny i określa typ parametrów i / lub dowolną nazwę parametru.

W elemencie AutoComplete możesz dodać atrybut language ale nie jest on używany przez Notepad ++, możesz go dodać dla kompletności, jeśli chcesz i możesz pobrać dowolny ciąg.