Herramientas de edición de scripts
De un vistazo
- Aprende a configurar las asociaciones de lenguajes, el resaltado de sintaxis y las plantillas de código reutilizables.
- Descubre los atajos para autocompletar código, consultar sugerencias de parámetros de métodos y navegar a las definiciones de variables y procedimientos.
- Aprende a añadir, activar, desactivar y configurar puntos de interrupción condicionales para examinar la ejecución del script.
El sistema de scripting de Altium Designer se compone de dos partes principales: el editor y el depurador. El editor ofrece diversas funciones de ayuda e inspección del código de los scripts, y el depurador proporciona acceso a los componentes de los scripts y a las funciones de depuración.
Herramientas de scripting
El sistema de scripting proporciona diversas herramientas para ayudarle a escribir y depurar scripts. Además de las funciones de autocompletado y análisis de código, el sistema de scripting permite recorrer los scripts de forma interactiva línea por línea, inspeccionar variables y objetos, y establecer puntos de interrupción en una o varias líneas del script.
Las herramientas del editor de scripts son un recurso clave para depurar scripts.
Configuración de lenguajes
Desde el cuadro de diálogo Language Setup , puede crear, editar y gestionar una lista de lenguajes que se pueden asociar a los documentos abiertos en una variante del editor de texto compatible con código. Cada lenguaje consta de un esquema de sintaxis, un conjunto de plantillas de código y una lista de asociaciones de archivos. Para acceder al cuadro de diálogo, haga clic en
en la barra de herramientas Text Utilities .

El cuadro de diálogo Language Setup
El cuadro de diálogo contiene una lista de los lenguajes definidos actualmente. Utilice este cuadro de diálogo para crear, duplicar, modificar y eliminar lenguajes según sea necesario. Para cada lenguaje, se debe definir lo siguiente:
- Las asociaciones de extensiones de archivo.
- La sintaxis del lenguaje (consulte los detalles a continuación).
- Las plantillas de código necesarias (consulte los detalles a continuación).
Resaltado de sintaxis
El resaltado de sintaxis es un método que se utiliza para facilitar la lectura de los documentos de texto, en el que se resaltan distintos elementos del documento según su sintaxis. Para ello, se asigna un color específico a las distintas palabras, símbolos e identificadores. Este conjunto de asignaciones de colores se denomina sintaxis del lenguaje.
El esquema de sintaxis del lenguaje asociado al documento actual se puede definir o editar desde el cuadro de diálogo Syntax Editor , al que se accede desde el editor de texto (o cualquier variante del editor de texto compatible con código) haciendo clic en el botón
de la barra de herramientas Text Utilities .

El cuadro de diálogo Syntax Editor
El cuadro de diálogo Syntax Editor se divide en cinco pestañas, cada una de las cuales representa un área diferente de la sintaxis del lenguaje:
- Options - se utiliza para definir diversas opciones generales de sintaxis.
- Comments - se utiliza para definir comentarios. Los comentarios son elementos del archivo de texto que desea definir como comentarios de código. Pueden definirse como comentarios de una sola línea, de línea completa o de varias líneas. Los comentarios se definen mediante sus delimitadores, es decir, los caracteres que indican que un bloque de texto es un comentario. Los comentarios de una sola línea y de línea completa solo requieren un delimitador izquierdo (el otro extremo se define mediante un carácter de fin de línea). Los comentarios de una sola línea pueden comenzar en cualquier punto de una línea, mientras que los comentarios de línea completa requieren que el delimitador del comentario sea el primer carácter de la línea. Los comentarios de varias líneas requieren un delimitador izquierdo y otro derecho para definir dónde empiezan y terminan.
- Strings - se utiliza para definir cadenas. Las cadenas son elementos del archivo de texto que desea definir como cadenas en el código, por ejemplo, las que aparecen como mensaje en un cuadro de diálogo que muestra su programa. Se admiten cadenas de una sola línea y de varias líneas, y ambos tipos requieren delimitadores izquierdo y derecho para definir sus puntos de inicio y fin.
- Numbers - se utiliza para definir números. Al igual que los comentarios y las cadenas, los números son otra clase de información del documento que puede interesarle destacar. Simple numbers se definen como cadenas de dígitos numéricos que pueden contener o no un punto decimal, por ejemplo, 45, 45.6 pero no 45.6.6. Los números simples también pueden incluir un carácter E, que indica notación científica, como 53E3 o 24e6. Special numbers se definen por tener un prefijo y/o un sufijo y contener dígitos numéricos o las letras A-F. Estos podrían utilizarse para indicar a un compilador que el número es hexadecimal u octal, por ejemplo. Algunos ejemplos de estos números son 0xAF034AD, 88j, j8A8y, pero no 0xA.4. Cada tipo de número se especifica mediante un sufijo, un prefijo o una combinación de ambos. El comportamiento básico de los prefijos y sufijos consiste en que, siempre que se detecta un prefijo o sufijo válido en combinación con un número, tanto el número como el prefijo (o sufijo) se resaltan según el estilo de número. Este comportamiento básico se puede modificar mediante las opciones adicionales disponibles.
- Keywords - se utiliza para definir palabras clave. Las palabras clave son un conjunto de palabras predefinidas que desea destacar en el documento. Normalmente son palabras reservadas por el lenguaje de programación para identificar una función, un procedimiento, un tipo de objeto, etc. Las palabras clave se definen como parte de uno o varios conjuntos de palabras clave, cada uno con su propio estilo (parámetros de color y fuente), lo que facilita aún más la lectura del documento.
Autocompletado de código
El editor admite una función de autocompletado de código, que consiste en una ventana emergente automática que muestra opciones de código según el contexto.
Al escribir un punto después del nombre de una interfaz de objeto, se muestra una lista de las propiedades y los métodos disponibles para ese objeto en una ventana de menú emergente de autocompletado de código; siga escribiendo para acotar la lista. Al seleccionar una opción de la lista, se insertará en el código el procedimiento, la función o la propiedad correspondiente.
Puede utilizar el atajo de teclado Ctrl+Space para abrir la ventana de la lista de autocompletado de código en cualquier momento.
La función de autocompletado de código resulta extremadamente útil para seleccionar la interfaz de objeto, el método y la propiedad correctos que se deben aplicar en un script.
Plantillas de sentencias
Las plantillas de código son bloques de código predefinidos que se pueden insertar automáticamente en un archivo de texto con funciones de edición de código y constituyen una excelente ayuda para mejorar la productividad al escribir código en un lenguaje determinado. Cada plantilla de código tiene tres propiedades: un nombre, una descripción y el código que insertará la plantilla.
La función de plantillas de scripts genera automáticamente una estructura de código para la sentencia seleccionada en la lista emergente.
La lista emergente se puede activar en cualquier momento mediante las teclas de acceso rápido Ctrl+J , el botón Show Code Templates en la barra de herramientas Text Utilities) o el comando Tools » Show Code Templates de los menús principales. Si se activa después de escribir las primeras letras de una sentencia de código, por ejemplo, 'proc', se insertará automáticamente en el código del documento la estructura Procedure de la sentencia correspondiente. Como alternativa, si hay varias sentencias disponibles para las letras de código ya escritas (por ejemplo, 'if'), la ventana de la lista de plantillas ofrecerá una lista filtrada de sentencias.
También puede colocar el cursor en la ubicación deseada del archivo y, a continuación, ejecutar el comando. Aparecerá una ventana emergente con todas las plantillas de código disponibles definidas para el lenguaje asociado. Seleccione la entrada deseada para insertar esa plantilla.
Cada plantilla de código se identifica por su nombre, tal como se especifica en el cuadro de diálogo Code Templates Editor. Puede acceder a este cuadro de diálogo desde el cuadro de diálogo Language Setup (haga clic en
en la barra de herramientas Text Utilities ), seleccionando el comando Templates de Menu.
Parámetros de métodos
La función de parámetros de métodos de scripts muestra un mensaje emergente que indica qué parámetros se utilizan para un método determinado (función, procedimiento, etc.) de la interfaz de un objeto.
Al escribir el paréntesis de apertura después de un método, como se muestra en la imagen siguiente, aparecerá automáticamente el mensaje de parámetros. Las teclas Shift+Ctrl+Space permiten mostrar manualmente el mensaje emergente de parámetros, cuando corresponda.
Para ver la definición de los parámetros de una sentencia de método ya completada, coloque el cursor dentro de los paréntesis de sus parámetros y utilice Shift+Ctrl+Space para abrir el mensaje emergente.
Navegación a definiciones
La función de navegación del editor permite localizar de inmediato el código fuente de la definición de una variable o un método de un script.
Para encontrar el origen de la definición de una variable, mantenga pulsada la tecla Ctrl mientras hace clic en la variable donde se utiliza en el script. El cursor se desplazará a la definición. Utilice el mismo método (Ctrl+Click) para localizar la definición de origen de un procedimiento. Si el procedimiento está definido en otro script del proyecto, dicho script se abrirá con el cursor situado en el procedimiento.
Información sobre herramientas Insight
La función de información sobre herramientas Insight muestra el tipo de variable al situar el cursor del ratón sobre ella. Del mismo modo, al situar el cursor sobre un procedimiento, se muestran su definición y su ubicación (script y número de línea).
Puntos de interrupción
Los puntos de interrupción son una herramienta de depuración fundamental que permite pausar la ejecución de un script en puntos predefinidos. Un uso habitual consiste en colocarlos en las distintas ramas de una sentencia condicional, insertando un punto de interrupción en cada rama para comprobar cuál se ejecuta.
La forma más sencilla de establecer un punto de interrupción es hacer clic en el margen del editor junto a una línea de código, que quedará resaltada en rojo. El resaltado de la línea cambiará a verde guisante cuando un script en ejecución alcance ese punto de interrupción. El script puede ejecutarse hasta el siguiente punto de interrupción mediante el comando Run (atajo de teclado: F9) o mediante los comandos de ejecución paso a paso.
Para activar o desactivar un punto de interrupción en la línea actual, también puede utilizar el comando Run » Toggle Breakpoint de los menús principales (atajo de teclado: F5).
Como alternativa, utilice el comando Run » Add Breakpoint de los menús principales para abrir el cuadro de diálogo Add New Breakpoint , desde el que puede definir un nuevo punto de interrupción para añadirlo a cualquier documento de script abierto. Utilice este cuadro de diálogo para definir en qué número de línea del documento seleccionado debe añadirse el punto de interrupción. El campo Condition del cuadro de diálogo permite definir un punto de interrupción condicional, de modo que la ejecución del script solo se detendrá si la condición asociada al punto de interrupción se evalúa como verdadera; de lo contrario, la ejecución continuará sin detenerse.
También puede elegir si el punto de interrupción debe añadirse inicialmente habilitado o deshabilitado. Un punto de interrupción deshabilitado permanece definido, pero no detendrá un script en ejecución cuando este lo alcance.

El cuadro de diálogo Add New Breakpoint
Se puede acceder a los puntos de interrupción a través del panel Breakpoints para localizar y gestionar fácilmente todos los puntos de interrupción establecidos, sin tener que recorrer el script para encontrarlos. El panel proporciona información sobre todos los puntos de interrupción definidos actualmente en todos los archivos de script abiertos (independientemente del proyecto de scripts (*.PrjScr) al que pertenezcan), además de ofrecer comandos para añadir, habilitar, deshabilitar y eliminar los puntos de interrupción seleccionados según sea necesario desde el menú contextual.

El panel Breakpoints
Haga doble clic en una entrada de punto de interrupción del panel (o seleccione el comando Edit Source del menú contextual) para convertir el documento de script asociado en el documento activo del espacio de diseño y situar el cursor de texto al principio de la línea del script a la que se aplica el punto de interrupción.
Seleccione el comando Properties del menú contextual para acceder al cuadro de diálogo Breakpoint Properties correspondiente a la entrada de punto de interrupción seleccionada. Puede utilizar este cuadro de diálogo para cambiar el estado del punto de interrupción (habilitarlo o deshabilitarlo) y también para añadir o modificar una condición para él según sea necesario. No puede cambiar el archivo en el que se ha añadido el punto de interrupción ni el número de línea específico dentro de ese archivo.

El cuadro de diálogo Breakpoint Properties
Evaluación de expresiones
Cuando un script se detiene debido a un punto de interrupción o a un error, el valor de cualquier expresión (una sentencia del script) se puede determinar mediante la función de información sobre herramientas o mediante el cuadro de diálogo interactivo Evaluate .
Las herramientas de evaluación son principalmente herramientas de depuración que se utilizan junto con paneles de ayuda para la depuración, como los paneles Watch List y Call Stack.
Información sobre herramientas de evaluación
La función de información sobre herramientas de evaluación de expresiones muestra el valor actual de la variable sobre la que se sitúa el cursor.
Función de evaluación
Para utilizar el cuadro de diálogo Evaluate del editor, haga clic en una variable de expresión del script y seleccione el botón Run » Evaluate (atajo de teclado: Ctrl+F7). El cuadro de diálogo se rellenará automáticamente con la expresión y su resultado actual.
También puede copiar una expresión del script en el campo Expression del cuadro de diálogo y hacer clic en Evaluate para ver el resultado. También puede escribir el nombre de una expresión directamente en el campo Expression para evaluar el resultado.

Un script detenido en un punto de interrupción con el cuadro de diálogo Evaluate activado.
Expresiones de seguimiento
Las expresiones de seguimiento permiten supervisar los valores de variables y expresiones mientras depura paso a paso el documento de script actual. Una expresión de seguimiento puede ser una sola variable o una expresión que contenga una o varias variables.
Para definir expresiones de seguimiento para el documento de script actual, utilice el comando Run » Add Watch de los menús principales (atajo de teclado: Ctrl+F5). Tras ejecutar el comando, aparecerá el cuadro de diálogo Add New Watch. Utilice este cuadro de diálogo para definir la expresión que desea supervisar. Por ejemplo, la expresión podría ser una variable concreta utilizada en el código (p. ej., OUT, a, Remainder) o una expresión basada en una o varias variables definidas (p. ej., a+b, a*b, c+(b-a)).

El cuadro de diálogo Add New Watch
Después de hacer clic en OK, la expresión de seguimiento aparecerá en el panel Watch List. Utilice el panel para ver todas las expresiones de seguimiento definidas al mismo tiempo. Puede añadir, editar y eliminar expresiones de seguimiento desde el menú contextual del panel.

El panel Watch List
A medida que avance por las líneas de código del documento de script, se evaluarán las expresiones de seguimiento y se actualizarán los valores correspondientes si el script modifica alguna de las variables utilizadas en esas expresiones.
Cuando la ejecución del script entre en una función o procedimiento, una expresión de seguimiento solo será válida si las variables de la expresión están definidas y se utilizan en esa función o procedimiento. Si una variable no está disponible para la función o el procedimiento (es decir, no es global o es local a otra parte del script), el campo Value mostrará Undeclared identifier: VariableName.
Haga doble clic en una entrada de seguimiento del panel o haga clic con el botón derecho en una entrada y seleccione el comando Edit Watch para acceder al cuadro de diálogo Watch Properties, desde el que podrá editar la expresión del seguimiento seleccionado según sea necesario.
Marcadores
Los marcadores se utilizan en los scripts para señalar instrucciones y acceder a ellas rápidamente. Se pueden definir hasta 10 marcadores en un script.
Un marcador se indica mediante un recuadro verde en el margen del editor, con el número del marcador en su interior. Para añadir un marcador, seleccione una línea de código, haga clic con el botón derecho, seleccione Toggle Bookmarks en el menú contextual y, a continuación, un número de ubicación en el submenú (Toggle Bookmarks » Set Location Mark n, donde «n» es el número del marcador, de 0 a 9).
Para ir (saltar) a un marcador, haga clic con el botón derecho y seleccione Goto Bookmarks y la ubicación del marcador deseado en el submenú (Goto Bookmarks » Jump Location Mark n). Para eliminar un marcador, desactívelo repitiendo el proceso de añadir un marcador para esa línea de código.

Utilice marcadores para saltar rápidamente a una instrucción del script.
Plegado de código
Para facilitar el trabajo con el código, los procedimientos, funciones y subrutinas del documento se organizan en bloques de código plegables. Estos bloques se pueden contraer o expandir para mostrar únicamente el contenido del documento que necesite en ese momento.
Para expandir o contraer un bloque de código individual, haga clic en el pequeño control
o
situado a la izquierda de la primera instrucción del bloque. Cuando está contraído, aparece un control
a la derecha de la primera instrucción de cada bloque de código. Al situar el puntero del ratón sobre él, se mostrará el código contraído. Al hacer doble clic en este control, se expandirá ese bloque de código.
Para expandir o contraer todos los bloques de código plegables del documento actual, haga clic con el botón derecho y elija Outlining » Collapse All o Expand All en el menú contextual.
Herramientas generales de edición de texto
Añadir tareas pendientes
Una tarea pendiente, como su nombre indica, se utiliza básicamente como recordatorio de una tarea relacionada con el documento que debe realizarse más adelante.
Para añadir una tarea pendiente en un punto del documento actual, sitúe el cursor de texto en ese punto, haga clic con el botón derecho y elija Add To-Do Item en el menú contextual. Tras ejecutar el comando, aparecerá el cuadro de diálogo Edit To-Do Item. Utilice este cuadro de diálogo para introducir un texto adecuado sobre la tarea que debe realizarse en ese punto del documento. Utilice los campos disponibles en el cuadro de diálogo para definir una Priority para la tarea (desde la más baja hasta la más alta, con Normal seleccionada de forma predeterminada), el Owner de la tarea y también una Category para la tarea (p. ej., revisión de formato, revisión de código, etc.).
Una vez definida la tarea pendiente según sea necesario, al hacer clic en OK se cerrará el cuadro de diálogo y el foco volverá al documento actual. Aparecerá una entrada para la tarea pendiente en el punto marcado por la posición actual del cursor de texto. La entrada aparecerá entre los delimitadores { y }, como se muestra en el siguiente ejemplo:
{TODO Name=Check Spelling|Priority=3|State=1|Owner=Jase|Category=Proofing|UID=UIDYOGFS}
Donde:
- Name es el texto de la acción que se debe realizar.
- Priority es un valor que representa la prioridad asignada (Lowest = 0, Low = 1, High = 3, Highest = 4). Si Priority se ha establecido en Normal, no se mostrará ninguna entrada.
- State refleja si el elemento se ha completado o no. Si no se ha completado, no se mostrará ninguna entrada. Si se ha completado, el valor de Estado será 1.
- Owner es el propietario asignado al elemento.
- Category es la categoría asignada al elemento.
- UID es el identificador único de ese elemento en particular.
Cambiar entre mayúsculas y minúsculas
Los comandos del menú Tools » Change Case permiten cambiar el uso de mayúsculas y minúsculas del texto seleccionado o de la palabra situada bajo el cursor.
- Selection To UpperCase – seleccione el texto que desea cambiar de lower a UPPER y ejecute el comando. La selección se convertirá a mayúsculas.
- Selection To LowerCase – seleccione el texto que desea cambiar de UPPER a lower y ejecute el comando. La selección se convertirá a minúsculas.
- Capitalize Selection – seleccione el texto cuyas iniciales desea convertir a mayúsculas y ejecute el comando. La primera letra de cada palabra de la selección que no empiece ya por mayúscula se convertirá a mayúscula.
- Word To UpperCase – sitúe el cursor de texto al principio, al final o en cualquier punto de la palabra que desea cambiar de lower a UPPER y ejecute el comando. La palabra se convertirá a mayúsculas.
- Word To LowerCase – sitúe el cursor de texto al principio, al final o en cualquier punto de la palabra que desea cambiar de UPPER a lower y ejecute el comando. La palabra se convertirá a minúsculas.
- Capitalize Word – sitúe el cursor de texto al principio, al final o en cualquier punto de la palabra cuya inicial desea convertir a mayúscula y ejecute el comando. La primera letra de la palabra se convertirá a mayúscula.
Sangría de texto
Para mejorar la legibilidad, puede aplicar sangría al texto del documento. Para aumentar o reducir la sangría del texto seleccionado en el documento actual, elija Tools » Indent o Tools » Unindent en los menús principales, o haga clic en el botón
/
de la barra de herramientas Text Utilities. La sangría de la selección aumentará o disminuirá en el número de caracteres especificado en el campo Block Indent, en la página Editores de texto - General del cuadro de diálogo Preferences.
Búsqueda y sustitución de texto
Para configurar una búsqueda de texto específico en el documento actual, en todos los documentos de texto del proyecto activo, en todos los documentos de texto abiertos o en todos los documentos de texto de un directorio especificado, se utiliza el cuadro de diálogo Find Text. Puede acceder a este cuadro de diálogo desde el Editor de texto (o desde cualquier variante del Editor de texto con funciones de programación) eligiendo el comando Edit » Find en los menús principales (atajo de teclado: Ctrl+F).

El cuadro de diálogo Find Text
El cuadro de diálogo funciona básicamente en dos modos, cuyas funciones se ofrecen mediante dos pestañas:
- Find - utilice las opciones de esta pestaña para configurar una búsqueda únicamente en el documento actual. Tras hacer clic en OK, se resaltará en el documento la primera coincidencia encontrada.
- Find in Files - utilice las opciones de esta pestaña para configurar una búsqueda en todos los documentos de texto del proyecto activo, en todos los documentos de texto abiertos o en todos los documentos de texto de un directorio especificado. Tras hacer clic en OK, todas las coincidencias encontradas en los archivos incluidos en el ámbito de búsqueda se mostrarán como entradas en el panel Messages. Cada mensaje indicará el archivo de origen, la línea en la que se encontró el texto buscado, el texto completo de esa línea y la posición del carácter de esa línea en la que comienza la cadena de texto buscada.
Para encontrar la siguiente aparición del texto de la última búsqueda especificada mediante el cuadro de diálogo Find Text, utilice el comando Edit » Find Next de los menús principales (atajo de teclado: F3). Tras ejecutar el comando, se localizará y resaltará la siguiente aparición del texto especificado en el campo Text to find del cuadro de diálogo Find Text. Utilice el comando repetidamente para recorrer todas las demás apariciones. Esta función aplica todas las opciones de criterios de búsqueda especificadas al realizar la búsqueda de texto original.
Active la opción Find selected text on Find Next, en la página Editores de texto - General del cuadro de diálogo Preferences, para utilizar este comando para encontrar rápidamente las siguientes apariciones del texto seleccionado actualmente, en lugar del texto utilizado en la búsqueda original.
También puede encontrar la siguiente aparición del texto seleccionado actualmente en el documento activo mediante el comando Edit » Find Next Selected de los menús principales (atajo de teclado: Ctrl+Shift+F). Tras ejecutar el comando, se seleccionará la siguiente aparición del texto seleccionado. Utilice el comando repetidamente para recorrer todas las demás apariciones. Esta función realiza básicamente una búsqueda de texto mediante el cuadro de diálogo Find Text, utilizando el texto seleccionado como entrada del campo Text to find. Esta función aplicará todas las opciones de criterios de búsqueda especificadas la última vez que se realizó una búsqueda de texto mediante el cuadro de diálogo Find Text.
Para configurar una búsqueda que permita localizar y sustituir texto específico en el documento actual, en todos los documentos de texto del proyecto activo, en todos los documentos de texto abiertos o en todos los documentos de texto de un directorio especificado, se utiliza el cuadro de diálogo Replace Text. Puede acceder a este cuadro de diálogo desde el Editor de texto (o desde cualquier variante del Editor de texto con funciones de programación) eligiendo el comando Edit » Replace en los menús principales (atajo de teclado: Ctrl+H).

El cuadro de diálogo Replace Text
El cuadro de diálogo funciona esencialmente en dos modos, cuyas funciones se ofrecen a través de dos pestañas:
- Replace Text - utilice las opciones de esta pestaña para configurar la sustitución de texto únicamente en el documento actual. Para sustituir solo la primera coincidencia del texto, haga clic en OK. Si la opción Prompt on replace está activada, el texto se resaltará y aparecerá un cuadro de diálogo para confirmar la sustitución. Haga clic en Yes para sustituir solo esta coincidencia. Desde este cuadro de diálogo podrá sustituir todas las coincidencias. Como alternativa, para sustituirlas todas desde el principio, haga clic en Replace All, en lugar de OK. De nuevo, todas las coincidencias del texto buscado se sustituirán directamente o mediante confirmaciones individuales, según el estado de la opción Prompt on replace.
- Replace in Files - utilice las opciones de esta pestaña para configurar la sustitución de texto en todos los documentos de texto del proyecto activo, en todos los documentos de texto abiertos o en todos los documentos de texto de un directorio específico. Tras hacer clic en OK, se sustituirán todas las coincidencias del texto encontradas en los archivos incluidos en el ámbito de búsqueda. De nuevo, puede optar por que se le solicite confirmación antes de cada sustitución activando previamente la opción Prompt on replace. Aparecerá el cuadro de diálogo Replacing para mostrar el progreso de la sustitución. Cada sustitución realizada se mostrará como una entrada en el panel Messages. Cada mensaje indicará el archivo de origen, la línea en la que se encontró el texto buscado, el texto completo de esa línea y la posición del carácter dentro de esa línea donde comienza la cadena de texto buscada.
En cada caso, aparecerá un cuadro de diálogo informativo que resumirá el número de sustituciones realizadas.
Para la búsqueda y la sustitución de texto, consulte las opciones relacionadas en la sección Find, en la página Editores de texto - General del cuadro de diálogo Preferences.
Opciones y controles del cuadro de diálogo Buscar y sustituir texto
Pestaña Buscar/Sustituir texto
- Text to find - introduzca la cadena de texto que desea buscar en el documento o utilice la lista desplegable para seleccionar una cadena de búsquedas anteriores.
- Replace with - introduzca la cadena de texto con la que desea sustituir el texto encontrado o utilice la lista desplegable para seleccionar una de las cadenas de sustitución anteriores. Este comando solo está disponible en el cuadro de diálogo Replace Text.
-
Options
- Case sensitive - marque esta casilla para que la búsqueda distinga entre mayúsculas y minúsculas.
- Whole words only - marque esta casilla para buscar solo palabras completas.
-
Regular expressions - marque esta casilla para buscar mediante expresiones regulares.
- ^ - solo se considerará una coincidencia si la cadena está al principio de una línea.
- $ - solo se considerará una coincidencia si la cadena está al final de una línea.
- . - representa cualquier carácter individual (p. ej., "te.t" coincide con "test", "text" y "tent", pero no con "tet").
- * - representa cualquier conjunto de caracteres, incluida la ausencia de caracteres (p. ej., "te*" coincide con "text", "tent" y "te", pero no con "t").
- + - representa cualquier conjunto de caracteres, excepto la ausencia de caracteres (p. ej., "te+" coincide con "text" y "tent", pero no con "te").
- [ ] - busca cualquiera de los caracteres incluidos entre corchetes.
- [^] - un acento circunflejo al principio de una cadena entre corchetes indica negación (p. ej., "[^tes]" coincide con cualquier carácter excepto t, e o s).
- [-] - un guion dentro de una cadena entre corchetes indica un intervalo de caracteres (p. ej., "[l-o]" coincide con los caracteres l, m, n y o).
- { } - se utiliza para agrupar caracteres o expresiones. Los grupos pueden anidarse, con un máximo de 10 grupos en un solo patrón.
- \ - una barra invertida antes de un carácter comodín indica al editor de texto que debe tratar ese carácter de forma literal, no como un comodín (p. ej., "\^test" no busca la cadena test al principio de una línea, sino la cadena "^test").
- Prompt on replace - marque esta casilla para que se solicite confirmación antes de realizar la sustitución. Este comando solo está disponible en el cuadro de diálogo Replace Text.
- Search hidden text - marque esta casilla para incluir el texto oculto en la búsqueda.
- Wrap search - marque esta casilla para continuar la búsqueda desde el inicio al llegar al final. Este comando solo está disponible en el cuadro de diálogo Find Text.
-
Direction - utilice estas selecciones junto con las opciones Origin para determinar desde dónde y cómo se busca el texto.
- Forward - seleccione esta opción para buscar hacia delante desde el cursor.
- Backward - seleccione esta opción para buscar hacia atrás desde el cursor.
-
Scope
- Global - seleccione esta opción para buscar en todo el documento.
- Selected text - seleccione esta opción para buscar solo en el texto seleccionado actualmente.
-
Origin - utilice estas selecciones junto con las opciones Direction para determinar desde dónde y cómo se busca el texto.
- From cursor - seleccione esta opción para iniciar la búsqueda desde la posición del cursor.
- Entire scope - seleccione esta opción para buscar en todo el documento.
Pestaña Buscar en archivos/Sustituir en archivos
- Text to find - introduzca la cadena de texto que desea buscar en el documento o utilice la lista desplegable para seleccionar una cadena de búsquedas anteriores.
- Replace with - introduzca la cadena de texto con la que desea sustituir el texto encontrado o utilice la lista desplegable para seleccionar una de las cadenas de sustitución anteriores. Este comando solo está disponible en el cuadro de diálogo Replace Text.
-
Options
- Case sensitive - marque esta opción para realizar la búsqueda distinguiendo entre mayúsculas y minúsculas.
- Whole words only - marque esta opción para buscar solo palabras completas.
-
Regular expressions - marque esta opción para buscar mediante expresiones regulares. Las expresiones regulares válidas incluyen las siguientes:
- ^ - solo encuentra coincidencias cuando la cadena está al principio de una línea.
- $ - solo encuentra coincidencias cuando la cadena está al final de una línea.
- . - representa un único carácter cualquiera (p. ej., "te.t" coincide con "test", "text" y "tent", pero no con "tet").
- * - representa cualquier conjunto de caracteres, incluida la ausencia de caracteres (p. ej., "te*" coincide con "text", "tent" y "te", pero no con "t").
- + - representa cualquier conjunto de caracteres, excepto la ausencia de caracteres (p. ej., "te+" coincide con "text" y "tent", pero no con "te").
- [ ] - busca cualquiera de los caracteres incluidos entre corchetes.
- [^] - un acento circunflejo al principio de una cadena entre corchetes indica negación (p. ej., "[^tes]" coincide con cualquier carácter excepto t, e o s).
- [-] - un guion dentro de una cadena entre corchetes indica un intervalo de caracteres (p. ej., "[l-o]" coincide con los caracteres l, m, n y o).
- { } - se utiliza para agrupar caracteres o expresiones. Los grupos se pueden anidar con un máximo de 10 grupos en un mismo patrón.
- \ - una barra invertida delante de un carácter comodín indica al editor de texto que trate ese carácter de forma literal, no como un comodín (p. ej., "\^test" no busca la cadena "test" al principio de una línea, sino que busca la cadena "^test").
- Prompt on replace - marque esta opción para que se solicite confirmación antes de realizar la sustitución. Este comando solo está disponible en el cuadro de diálogo Replace Text.
- Search hidden text - marque esta opción para incluir el texto oculto en la búsqueda.
-
Where
- Search all files in project - seleccione esta opción para buscar en todos los archivos del proyecto actual.
- Search all open files - seleccione esta opción para buscar en todos los archivos abiertos.
- Search in directories - seleccione esta opción para buscar en directorios.
- Open changed files in editor - seleccione esta opción para abrir los archivos modificados.
-
Search Directory Options
-
File Mask - haga clic en el botón Browse para abrir un cuadro de diálogo y seleccionar la carpeta en la que desea buscar.
- Include subdirectories - marque esta opción para incluir los subdirectorios en la búsqueda.
-
File Mask - haga clic en el botón Browse para abrir un cuadro de diálogo y seleccionar la carpeta en la que desea buscar.
Control adicional
- Replace All - haga clic para sustituir todas las cadenas encontradas por el texto introducido en el cuadro de texto Replace with. Este comando solo está disponible en el cuadro de diálogo Replace Text.
Ir a una línea específica
Para ir a una línea específica del documento actual, seleccione Edit » Goto Line Number en los menús principales. Tras ejecutar el comando, aparecerá el cuadro de diálogo Go to Line Number.

El cuadro de diálogo Go to Line Number
Inicialmente, el cuadro de diálogo mostrará la línea en la que se encuentra el cursor de texto. Introduzca el número de la línea a la que desea desplazar el cursor en el campo New Line Number. Si el número de línea es mayor que el número de líneas del documento, el cuadro de diálogo volverá a aparecer para que introduzca un número de línea válido. Después de hacer clic en OK, el cursor se desplazará a la misma posición en la línea especificada.
Abrir el documento bajo el cursor
El documento sobre cuyo nombre se encuentra el cursor se puede abrir automáticamente desde el editor de texto. Sitúe el cursor de texto dentro del texto que describe el documento que desea abrir, haga clic con el botón derecho y seleccione Open Document Under Cursor en el menú contextual (atajo de teclado: Ctrl+Enter). El documento se abrirá y se convertirá en el documento activo.
Por ejemplo, para abrir un documento llamado Example_Schematic.SchDoc, asegúrese primero de que el texto Example_Schematic.SchDoc esté escrito en algún lugar del documento de texto actual. A continuación, sitúe el cursor de texto en cualquier punto de esta cadena y ejecute el comando: Example_Schematic.SchDoc se abrirá como documento activo.
Ajuste de línea
Si el documento incluye líneas de texto largas, puede facilitar su lectura de forma manual, insertando retornos de carro, o activando el ajuste de línea. Para gestionar el ajuste de línea, utilice los comandos del menú principal Tools » Word Wrap:
- None – desactiva el modo de ajuste de línea en el documento actual. Tras ejecutar el comando, el texto introducido dejará de ajustarse tanto al margen derecho como al borde derecho de la ventana del área de visualización.
-
At Margin (o el botón
de la barra de herramientas Text Utilities) – las líneas de texto se ajustarán al margen en el documento actual. Tras ejecutar el comando, el texto introducido se ajustará al margen derecho, definido por el valor introducido en el campo Margin width, en la página Editores de texto - Visualización del cuadro de diálogo Preferences.
-
At Window (o el botón
de la barra de herramientas Text Utilities) – las líneas de texto se ajustarán al borde de la ventana de visualización en el documento actual. Tras ejecutar el comando, el texto introducido se ajustará al borde derecho de la ventana del área de visualización.
División de la vista del documento
Puede dividir la vista del documento actual en dos secciones horizontales o verticales independientes, lo que le permite explorar y editar dos áreas distintas del mismo documento. Para dividir la ventana del documento en dos secciones iguales, seleccione uno de los siguientes comandos:
- Window » Split Horizontally – la mitad superior mostrará un área desde el inicio (parte superior) del documento. La mitad inferior mostrará un área desde el punto del documento que se encontraba originalmente en la parte superior de la ventana de visualización antes de ejecutar el comando.
- Window » Split Vertically – la mitad izquierda mostrará un área desde el inicio (parte superior) del documento, con la barra de desplazamiento horizontal situada completamente a la izquierda. La mitad derecha mostrará un área desde el punto del documento que se encontraba originalmente en la parte superior de la ventana de visualización antes de ejecutar el comando.
Ahora puede explorar y editar libremente distintas áreas del documento actual (único).
Una «barra divisoria» separa las dos secciones. Haga clic en esta barra y arrástrela para cambiar el área del documento visible en cada sección.
Para volver a una sola ventana para el documento, utilice el comando Remove Split, al que se accede desde el menú Window. Al eliminar la división, se mostrará el área del documento que se esté visualizando en la sección inferior (en el caso de una división horizontal) o en la sección derecha (en el caso de una división vertical).