Herramientas de edición de scripts

De un vistazo

Explora las herramientas de edición y depuración de scripts disponibles en Altium Designer, desde el resaltado de sintaxis personalizable y las plantillas de código hasta el autocompletado de código sensible al contexto y los puntos de interrupción. Este artículo explica cómo acceder a estas funciones, navegar por las definiciones del script y consultar los parámetros de los métodos para facilitar tu flujo de trabajo con scripts. Esta página también incluye información detallada sobre las diversas herramientas de edición de texto de uso general disponibles. Sigue leyendo para aprovechar estas herramientas en tu próximo script.

- 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.
Profundiza con IA:
 

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 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:

  • La asociación de una extensión de archivo a un lenguaje es única; si añade la misma extensión a otro lenguaje, la asociación con el lenguaje anterior se elimina automáticamente.
  • Si un archivo con una extensión determinada está asociado a un lenguaje, su contenido se resalta de acuerdo con la sintaxis definida para ese lenguaje.
  • Al duplicar un lenguaje, también se copian su esquema de sintaxis y todas las plantillas de código que contiene.

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 

Aunque el comando está disponible de forma general en la barra de herramientas Text Utilities, tenga en cuenta que los archivos de texto estándar (*.txt) no tienen ningún lenguaje asociado y, por lo tanto, no se permite acceder al cuadro de diálogo desde un documento de este tipo.

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.
  • Active o desactive el resaltado de sintaxis para cada uno de los elementos de sintaxis en sus respectivas pestañas. Si la opción de resaltado de un elemento de sintaxis está desactivada, cualquier elemento de ese tipo presente en el documento dejará de resaltarse y volverá al estilo del texto normal.
  • Si la misma palabra clave aparece en más de un conjunto de palabras clave, se aplicará el estilo de resaltado del conjunto que aparezca primero en la lista.
  • Las palabras clave pueden contener caracteres alfabéticos, numéricos y el carácter de guion bajo. La palabra clave no puede comenzar con un carácter numérico.

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 lista de autocompletado de código también incluirá los procedimientos y las funciones globales disponibles en el proyecto abierto actualmente, incluidos los del script actual.

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.

El mensaje emergente de parámetros también muestra la ubicación de origen de la definición del método (función o procedimiento), cuando corresponda. En el ejemplo anterior, el método (ShowAParametricMessage) está definido en el script HelloWorld.pas, en la línea 14. Pase el cursor sobre la imagen para ver cómo se utiliza el método en el script HelloWorldDialog.

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. 

  • Un punto de interrupción habilitado se indica en el código mediante un resaltado rojo en su línea y un círculo rojo con una cruz en el margen (). Un punto de interrupción deshabilitado se indica en el código mediante un resaltado verde en su línea y un círculo verde con una cruz en el margen ().
  • Un punto de interrupción deshabilitado no se puede eliminar directamente desde el documento de script. En estado deshabilitado, solo se puede eliminar desde el panel de puntos de interrupción.

El cuadro de diálogo Add New Breakpoint 
El cuadro de diálogo Add New Breakpoint 

Tenga en cuenta que un punto de interrupción de un script debe estar en una línea que contenga una sentencia. Se ignorarán los puntos de interrupción establecidos en líneas en blanco, líneas comentadas u otras líneas que no contengan sentencias.

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
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 
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.
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
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
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.

La ubicación guardada solo estará disponible mientras el documento permanezca abierto (esté activo o no). Si se cierra el documento y se vuelve a abrir, el marcador de ubicación estará vacío.

Utilice marcadores para saltar rápidamente a una instrucción del script.
Utilice marcadores para saltar rápidamente a una instrucción del script.

  • Utilice el atajo de teclado Ctrl+n para saltar a un marcador existente en el script (donde n es el número del marcador, de 0 a 9). Por ejemplo, para ir al marcador número 3, pulse el atajo de teclado Ctrl+3.
  • Utilice el atajo de teclado Ctrl+Shift+n para activar o desactivar un marcador (donde n es el número del marcador que desea activar o desactivar), o para mover un marcador asignado a la línea actual.

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. 

El uso del plegado de código, incluida la opción de mostrar las líneas de contracción —que indican la extensión de cada bloque de código—, se activa o desactiva desde la página Editores de texto - Visualización del cuadro de diálogo Preferences.

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.
Todos los elementos de tareas pendientes del proyecto activo se muestran en el panel To-Do.

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.

Si la opción Backspace unindents está activada (en la página Text Editors - General del cuadro de diálogo Preferences ), puede reducir la sangría con la tecla Backspace . Sitúe el cursor de texto antes del primer carácter que no sea un espacio en la línea cuya sangría desea reducir y pulse Backspace. La sangría de la línea se reducirá, alineándose con el inicio de las palabras de la línea anterior.

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 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.
  • Cada mensaje del panel Messages tiene el formato (x, y): <LineText>, donde x es la posición del carácter en la línea y del documento.
  • No es necesario que los archivos estén abiertos para buscar texto con el modo Find in Files.
  • Al utilizar el modo Find in Files, puede acceder directamente al texto encontrado desde la entrada del panel Messages ; basta con hacer doble clic en el mensaje.

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 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.

  • Cada mensaje del panel Messages tiene el formato (x, y): <OriginalLineText>, donde x es la posición del carácter en la línea y del documento. El texto muestra el contenido original, antes de la sustitución.
  • No es necesario que los archivos estén abiertos para sustituir texto mediante el modo Replace in Files. Si lo desea, estos archivos pueden abrirse después de la sustitución activando la opción Open changed files in editor antes de realizarla.
  • Al utilizar el modo Replace in Files, puede acceder al texto sustituido mediante navegación cruzada desde la entrada del panel Messages : basta con hacer doble clic en el mensaje.

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.

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
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.

Puede resultar muy útil activar la visualización de los números de línea. Puede hacerlo mediante la opción Show line numbers (y sus subopciones relacionadas), en la página Editores de texto - Visualización del cuadro de diálogo Preferences.

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.

  • Esta función no distingue entre mayúsculas y minúsculas, por lo que el uso de mayúsculas y minúsculas en el texto introducido no tiene que coincidir con el del nombre del archivo que se va a abrir.
  • Esta función solo abrirá documentos cuyos nombres de archivo no contengan espacios. Por ejemplo, tanto Example_Design_File.SchDoc como ExampleDesignFile.SchDoc se abrirán con esta función, pero Example Design File.SchDoc no.
  • Esta función solo abrirá documentos almacenados en la misma ubicación del disco duro que el documento de texto desde el que se realiza la llamada. Si el documento no se encuentra en ese directorio, aparecerá un cuadro de diálogo Open, desde el que podrá buscar y abrir el documento deseado.
  • Si un documento ya está abierto cuando se realiza la llamada, pasará a ser el 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.
  • Puede cambiar entre los modos de ajuste de línea en cualquier momento: el texto del documento se reformateará para adaptarse al modo seleccionado.
  • El ajuste de línea también se puede configurar mediante la opción Word wrap (y sus subopciones relacionadas) en la página Editores de texto - Visualización del cuadro de diálogo Preferences.

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).

Si desea cambiar el modo de división de horizontal a vertical o de vertical a horizontal, utilice el comando Split Vertically o Split Horizontally, respectivamente, disponibles también en el menú Window.
Las operaciones habituales de edición de texto y de scripts tienen asignados atajos de teclado; consulte Atajos de teclado del editor de documentos de texto.
AI-LocalizedLocalizado por IA
Si encuentra un problema, seleccione el texto/imagen y presioneCtrl + Enterpara enviarnos sus comentarios.
Nav
Contents
Disponibilidad de funciones

Las funciones disponibles para usted dependen de qué solución de Altium tenga: Altium Develop, Altium Agile Teams, Altium Agile Enterprise o Altium Designer (con suscripción activa).

Si no ve una función documentada en su software actual, contacte con Ventas de Altium para obtener más información.

Documentación heredada

La documentación de Altium Designer ya no está versionada. Si necesita acceder a la documentación de versiones anteriores de Altium Designer, visite la sección Documentación heredada de la página de Otros instaladores.

Contents