Perspectiva

Las directivas del IDE son similares a las directivas del compilador: una clase especial de comantarios puestos en su código fuente. Están encerradas por llaves con un signo de porcentaje. Por ejemplo:

{%H-}

El compilador los ve simplemente como comentarios y los ignora. El IDE usa estas directivas para guardar información específica del código fuente el cual es independiente del proyecto y sesión.

Ocultar una pista (hint), nota o advertencia

Para ocultar una sola pista, nota o advertencia use la siguiente directiva IDE:

procedure HagaAlgo({%H-}SinUsar: char);
begin

end;

Esto suprimirá la línea en la ventana de Mensajes de Lazarus que sin duda reportaría

Hint: Parámetro "SinUsar" no se ha usado

El compilador procesará la pista, pero la directiva {%H-} hará que el IDE filtre la pista fuera de la vista de los Mensajes.

Nota: Puede clicar derecha en una pista de la ventana de mensaje y escoger el menú contextual la opción "Ocultar el mensaje via directiva" para insertar la directiva automáticamente.

Esta característica se introdujo en Lazarus 0.9.29.

Codificación de Archivo

Puede especificar la codificación que el IDE debería usar para un archivo fuente agregando un BOM o una directiva de codificación en el mero inicio de un archivo fuente:

{%encoding CP1250}

Vea la unidad lcl/lconvencoding.pas para todos los valores posibles.

Ejecutar/Construir un archivo

El IDE puede ejecuta y construir archivos individuales en vez de proyectos. Los parámetros para construir/ejecutar un archivo se guardan como directivas de IDE dentro del archivo propio.

• {%BuildCommand <línea de comando usada para construir, por defecto es $(CompPath) $(EdFile)>}
• {%BuildWorkingDir <directorio de trabajo, por defecto es la ruta del archivo>}
• {%BuildScan <parsers>} Lista de analizadores de sintáxis usada para construir la salida
• {%RunCommand <línea de comandos usada para ejecutar, por defecto es $NameOnly($(EdFile))>}
• {%RunWorkingDir <directorio de trabajo, por defecto es la ruta del archivo>}
• {%RunFlags <flags, default Build+>} donde las banderas es una lista de opciones separada por espacios. P.e. {%RunFlags Messages+ Build+}
  • Build+ construir antes de ejecutar, por defecto, activada: on
  • Messages+ mostrar la salida de ejecución en la ventana de Mensajes, por defecto, desactivada: off

Vea Archivo de Configurar la Construcción.

Otras directivas IDE

• {%Region} Permite que usted defina su bloque de código personalizado Pliegue de Código, al colocar este comentario especial en el código. Deberá especificar el final de la región plegada mediante {%Endregion}
• {%MainUnit ruta/hacia/unit.pas} Usado como primera línea en un archivo include para dar una pista a codetools sobre dónde va el archivo de unidad. Cualquier / ó ** se convierten al delimitador de ruta actual.

Leyendo / encontrando directivas IDE

La unidad codetools basiccodetools contiene varias funciones para leer directivas IDE:

• FindNextIDEDirective
• CodeToolBoss.GetIDEDirectives

Traducido por edgarrod71@gmail.com

From the Free Pascal wiki, page "IDE directives/es", as it stood on 2023-03-08 after a change by Edgardager, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's Licensing page. If you have concerns about this material, message the admin.