Uso de los plugins

Cómo instalar un plugin

El plugin (en formato DLL) debe colocarse en el directorio Notepad++\plugins. Una vez instalado el plugin, podrá usarlo (y configurarlo) mediante el menú "Plugins".

Cómo crear un plugin

Se utiliza el sistema de mensajes de Windows para evitar la sobrecarga. Esto significa que el sistema de plugins proporciona algunos gestores de Notepad++ para dar más posibilidades y flexibilidad a los desarrolladores. Por ahora hay tres gestores de ventana disponibles: El gestor principal de Notepad++ y dos gestores de ventanas de Scintilla.

Con estos tres gestores de ventanas puede hacerlo casi todo, sólo envíe el mensaje adecuado al gestor apropiado para consegir su objetivo.

Estos son dos proyectos de plugins de muestra:

• Puede realizar su proyecto a partir de NppPluginDemo.zip, que es el esqueleto básico.
• NppInsertPlugin.zip es un proyecto completo en funcionamiento que le dará una idea mejor de cómo funciona.

La interfaz (el archivo de cabecera) del plugin está escrita en C para el programador de C/C++. Si usted la traduce a fin de programar en otro lenguaje, por favor, hágamelo saber. La incluiré para los desarrolladores en el otro lenguaje.

Mensajes de Notepad++:

• WM_GETCURRENTSCINTILLA
  
  

  wParam	lParam
  0	[out] int * currentEdit

  
  currentEdit indica la vista actual de Scintilla: 0 es la vista principal de Scintilla, 1 es la vista secundaria.


• WM_GETCURRENTLANGTYPE
  
  

  wParam	lParam
  0	[out] int * langType

  
  langType indica el tipo de lenguaje del documento de la vista actual de Scintilla: por favor, vea enum LangType en "PluginInterface.h" para todos los valores posibles.


• WM_SETCURRENTLANGTYPE
  
  

  wParam	lParam
  0	[in] int langTypeToSet

  
  langTypeToSet se usa para establecer el tipo de lenguaje del documento de la vista actual de Scintilla: por favor, vea enum LangType en "PluginInterface.h" para todos los valores posibles.


• WM_GET_FULLCURRENTPATH
  
  

  wParam	lParam
  0	[out] char * fullPath

  
  fullPath recibe la ruta completa del documento de la vista actual de Scintilla. Corresponde al usuario asignar (o usar una variable automática) un búfer con suficiente tamaño. Se sugiere utilizar MAX_PATH.


• WM_GET_FILENAME
  
  

  wParam	lParam
  0	[out] char * fileName

  
  fileName recibe el nombre de archivo del documento de la vista actual de Scintilla. Corresponde al usuario asignar (o usar una variable automática) un búfer con suficiente tamaño. Se sugiere utilizar MAX_PATH.


• WM_GET_CURRENTDIRECTORY
  
  

  wParam	lParam
  0	[out] char * directoryPath

  
  directoryPath recibe la ruta del directorio del documento de la vista actual de Scintilla. Corresponde al usuario asignar (o usar una variable automática) un búfer con suficiente tamaño. Se sugiere utilizar MAX_PATH.


• WM_NBOPENFILES
  
  

  wParam	lParam
  0	0

  
  The return value is the total number of files opened in Notepad++.


• WM_GETOPENFILENAMES
  
  

  wParam	lParam
  [in] int nbFile	[out] char ** fileNames

  
  
  • nbFile is the size of your fileNames array. You should get this value by using WM_NBOPENFILES message, then allocate fileNames array with this value.
    
  • fileNames receives the full path names of all the opened files in Notepad++. User is responsible to allocate fileNames array with an enough size.
    
  • The return value is the number of file full path names copied in fileNames array.


• WM_DOOPEN
  
  

  wParam	lParam
  0	[in] char * fullPathName2Open

  
  
  • fullPathName2Open indicates the full file path name to be opened.
    
  • The return value is TRUE (1) if the operation is successful, otherwise FALSE (0).

Mensajes de Scintilla :

Aquí encontrará documentación para todos los mensajes de Scintilla.