Descripción general y configuración del sistema de scripting
De un vistazo
- Comprende la función de las unidades de script, los formularios de script y los paneles utilizados para escribir y depurar scripts.
- Aprende a abrir y ejecutar un script de ejemplo, incluido el proyecto «Hola mundo».
- Descubre los ajustes del comportamiento del editor, los colores de sintaxis, las opciones de visualización, los proyectos de scripts globales y el diseño de formularios.
El sistema de scripting de Altium Designer proporciona todas las herramientas y funciones necesarias para crear scripts que automaticen tareas en el software.
El editor de scripts, el depurador y los paneles de scripting trabajan conjuntamente para ayudarle a escribir y depurar sus scripts con facilidad. Un script puede ejecutarse directamente desde el editor de scripts o asignarse a un menú, una barra de herramientas o una tecla de acceso rápido para aplicarlo al documento actual, como un diseño de PCB, en cualquier momento.

Altium Designer con las ventanas de código y formulario del script y los paneles Object Inspector, Code Explorer y Tool Palette .
Funciones del sistema de scripting
El sistema de scripting consta de dos partes principales: el editor y el depurador. Sus funciones principales son las siguientes:
-
Project access – Los scripts pueden guardarse en un proyecto de scripts o de diseño. Las rutinas de cualquier script de un proyecto son accesibles para los demás scripts del mismo proyecto.
-
Scripting Editor – El editor de scripts dispone de un editor de texto dedicado con diversas opciones para configurar el entorno de edición y el coloreado de sintaxis.
-
Scripting Panels – El sistema de scripting cuenta con varios paneles que le ayudan a programar y depurar scripts rápidamente.
-
Scripting Debugger – Si un script presenta un error durante su ejecución, aparece un cuadro de diálogo con un mensaje de error conciso. Puede consultar las variables en la ventana de inspección, seguir la ejecución del código y controlar la ejecución del script con el depurador de scripts.
-
Scripting Languages – Los scripts pueden crearse en DelphiScript y, si se habilita como lenguaje heredado, en VBScript.
Unidades y formularios de script
Los proyectos de scripts admiten dos tipos de documentos: unidades de script y formularios de script. Las unidades de script permiten escribir procedimientos y funciones independientes. Los formularios de script permiten crear cuadros de diálogo con controles y controladores de eventos, así como procedimientos y funciones.
- Una unidad de script puede utilizar la interfaz de programación de aplicaciones (API) X2 para modificar o manipular objetos de diseño en un documento de diseño. Un formulario de script aloja controles a modo de interfaz de usuario y aprovecha la API X2 para proporcionar cuadros de diálogo de script que actúan sobre los documentos de diseño activos.
- Un formulario de script es una unidad de formulario visual respaldada por el script. Cuando un formulario está activo, representa una ventana de diálogo.
- Un formulario de script tiene dos vistas: la vista de código del script y la vista de formulario del script. La vista de código del script contiene controladores de eventos y procedimientos o funciones. La vista de formulario del script representa un formulario de diálogo (de distintos tipos) y contiene controles junto con sus controladores de eventos asociados.
-
Un formulario de script tiene dos archivos asociados: un archivo
*.pasque contiene los controladores de eventos y los procedimientos o funciones, y un archivo*.dfmque contiene los detalles del propio formulario de script junto con sus componentes y sus ubicaciones. - Un componente es un objeto de control visual o no visual (colocado desde el panel de paleta de herramientas) que acepta entradas del usuario, como un clic del ratón o una secuencia de caracteres introducidos. Durante el diseño, puede utilizarse el panel del inspector de objetos para manipular los componentes de un formulario de script. Los componentes pueden utilizarse en cualquier formulario de script y con cualquier lenguaje compatible con el sistema de scripting.
-
Un componente (objeto de control) tiene métodos, propiedades y eventos que pueden utilizarse en un formulario de script.
- Los métodos son las acciones que puede realizar un objeto.
- Las propiedades representan los datos contenidos en el objeto a los que se puede acceder o que se pueden modificar.
- Los eventos son condiciones a las que puede reaccionar un componente de un formulario de script.
- Un formulario de script tiene controladores de eventos que procesan las condiciones detectadas, como un clic en un botón del formulario.
Ejemplos de scripts de Altium Designer
Los scripts de ejemplo y de referencia son un recurso útil para comprender cómo se aplican en los scripts las interfaces de objetos, los métodos, los procesos, las propiedades y los componentes. También pueden utilizarse como base para sus propios proyectos de scripts.
Ejecución de un ejemplo
Para ejecutar rápidamente un ejemplo de script en Altium Designer, abra primero un proyecto de ejemplo o un archivo de script individual de una de las carpetas de scripts de ejemplo; por ejemplo, el sencillo proyecto «Hello World» (HelloWorld.PRJSCR) de la carpeta Scripts\Delphiscript Scripts\General.

El proyecto Hello World de DelphiScript abierto en el panel Projects .
El proyecto contiene dos versiones del script «Hello World», y la segunda (HelloWorlDialog.pas) muestra el uso básico de una unidad de formulario. Haga doble clic en el nombre de un script para abrirlo y examinarlo en el editor. Tenga en cuenta que un script puede ejecutarse sin estar abierto en el editor.
Para ejecutar uno de los scripts, seleccione File » Run Script en los menús principales y, a continuación, elija un procedimiento de script disponible en el cuadro de diálogo Select Item To Run. Al ejecutar una de las versiones, se abrirá un cuadro de diálogo para mostrar el mensaje.
La forma rápida y sencilla de ejecutar un script de ejemplo.
Configuración del sistema de scripting
Preferencias
Las preferencias predeterminadas del sistema de scripting pueden configurarse en el cuadro de diálogo Preferencias, al que se accede haciendo clic en el botón de control
situado en la parte superior derecha del espacio de diseño.
Preferencias generales
La página Editores de texto – General del cuadro de diálogo Preferences permite configurar las opciones de edición de scripts según sus necesidades, como el comportamiento de búsqueda de cadenas, la tabulación y la sangría de las líneas, la asignación de teclas y otras opciones avanzadas.

La página Text Editors – General del cuadro de diálogo Preferences
Preferencias de color
La página Editores de texto – Colores del cuadro de diálogo Preferences permite configurar los colores de sintaxis del editor de scripts para el lenguaje de scripting que elija, así como los colores de sus elementos. Por ejemplo, negro para el fondo, blanco para las palabras clave de los comentarios, etc.

La página Text Editors – Colors del cuadro de diálogo Preferences
Preferencias de visualización
La página Editores de texto – Visualización del cuadro de diálogo Preferences permite configurar las características visuales de los scripts, como la visualización de los márgenes derechos y los números de línea, el resaltado de sintaxis y el plegado de código.

La página Text Editors – Display del cuadro de diálogo Preferences
Preferencias de proyectos globales
La página Sistema de scripting – Proyectos globales del cuadro de diálogo Preferences muestra los proyectos de scripts disponibles (instalados). Los proyectos de scripts se pueden instalar, eliminar o reordenar.

La página Scripting System – Global Projects del cuadro de diálogo Preferences
Preferencias del diseñador de formularios
La página Sistema de scripting – Diseñador de formularios del cuadro de diálogo Preferences ofrece las opciones de cuadrícula y de designadores de componentes para un documento de formulario de script.

La página Scripting System – Form Designer del cuadro de diálogo Preferences