Sign in Join
Wiki copytemporary

IDE directives/es: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: IDE directives/es

OldNewLine
1+# Perspectiva
2+
3+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:
4+
5+``` pascal
6+{%H-}
7+```
8+
9+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.
10+
11+# Ocultar una pista (hint), nota o advertencia
12+
13+Para ocultar una sola pista, nota o advertencia use la siguiente directiva IDE:
14+
15+``` pascal
16+procedure HagaAlgo({%H-}SinUsar: char);
17+begin
18+
19+end;
20+```
21+
22+Esto suprimirá la línea en la ventana de Mensajes de Lazarus que sin duda reportaría
23+
24+`Hint: Parámetro "SinUsar" no se ha usado`
25+
26+El compilador procesará la pista, pero la directiva {%H-} hará que el IDE filtre la pista fuera de la vista de los Mensajes.
27+
28+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.
29+
30+Esta característica se introdujo en Lazarus 0.9.29.
31+
32+# Codificación de Archivo
33+
34+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:
35+
36+``` pascal
37+{%encoding CP1250}
38+```
39+
40+Vea la unidad lcl/lconvencoding.pas para todos los valores posibles.
41+
42+# Ejecutar/Construir un archivo
43+
44+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.
45+
46+- {%BuildCommand \<línea de comando usada para construir, por defecto es \$(CompPath) \$(EdFile)\>}
47+- {%BuildWorkingDir \<directorio de trabajo, por defecto es la ruta del archivo\>}
48+- {%BuildScan \<parsers\>} Lista de analizadores de sintáxis usada para construir la salida
49+- {%RunCommand \<línea de comandos usada para ejecutar, por defecto es \$NameOnly(\$(EdFile))\>}
50+- {%RunWorkingDir \<directorio de trabajo, por defecto es la ruta del archivo\>}
51+- {%RunFlags \<flags, default Build+\>} donde las banderas es una lista de opciones separada por espacios. P.e. {%RunFlags Messages+ Build+}
52+ - Build+ construir antes de ejecutar, por defecto, activada: on
53+ - Messages+ mostrar la salida de ejecución en la ventana de Mensajes, por defecto, desactivada: off
54+
55+Vea [[IDE Window: Configure Build file|Archivo de Configurar la Construcción]].
56+
57+# Otras directivas IDE
58+
59+- {%Region} Permite que usted defina su bloque de código personalizado [[IDE Window: Editor Options Code Folding|Pliegue de Código]], al colocar este comentario especial en el código. Deberá especificar el final de la región plegada mediante {%Endregion}
60+- {%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.
61+
62+# Leyendo / encontrando directivas IDE
63+
64+La unidad codetools basiccodetools contiene varias funciones para leer directivas IDE:
65+
66+- FindNextIDEDirective
67+- CodeToolBoss.GetIDEDirectives
68+
69+Traducido por edgarrod71@gmail.com
70+
71+---
72+*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](/wiki-contact).*

Back to history