Descripción general y configuración del sistema de scripting

De un vistazo

Explora las herramientas y los ajustes disponibles para crear scripts en Altium Designer, desde el editor y el depurador hasta las unidades de script, los formularios y los proyectos de ejemplo. Este artículo presenta el entorno de scripting, explica cómo ejecutar un ejemplo sencillo y describe las preferencias para configurar tu espacio de diseño. Sigue leyendo para dar tus primeros pasos hacia la automatización de tareas en Altium Designer.

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

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

  • El lenguaje de scripting predeterminado es DelphiScript. Puede abrir y ejecutar scripts existentes escritos en VBScript y JavaScript (Jscript). Para poder crear nuevos scripts escritos en VBScript, debe habilitar la opción Legacy.Scripts.SupportOldLanguages en el cuadro de diálogo de configuración avanzada.

  • La documentación de la API de scripting se encuentra aquí: Objetos de la API de scripting. Tenga en cuenta que esta documentación se actualizó por última vez para una versión antigua de Altium Designer. Aunque muchos de los principios y enfoques siguen siendo los mismos, las interfaces, los objetos, los métodos, las propiedades y otros elementos han cambiado desde entonces y la documentación no refleja la totalidad de los que se encuentran en versiones posteriores del software.

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 *.pas que contiene los controladores de eventos y los procedimientos o funciones, y un archivo *.dfm que 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.

La documentación de scripting se centra principalmente en el lenguaje DelphiScript. Este lenguaje se basa en la tecnología DelphiScript de Embarcadero. Para obtener información sobre las diferencias entre DelphiScript y Object Pascal (utilizado en Delphi), consulte el documento de referencia de DelphiScript.

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.

Los diseños de referencia heredados, creados con el lanzamiento de Altium Designer 10, pueden descargarse aquí. Incluyen varios ejemplos de simulación y scripting. Tenga en cuenta que se trata de recursos heredados y que no se actualizan.
Para obtener información sobre otros ejemplos de scripts, consulte la Referencia de ejemplos de scripts. Para obtener una descripción práctica de ejemplos de scripts funcionales en Altium Designer, consulte Escritura de scripts y Análisis de un ejemplo de script.

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.

Los ejemplos de scripts estarán disponibles en la carpeta extraída del archivo ZIP descargado.

El proyecto Hello World de DelphiScript abierto en el panel Projects .
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.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
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
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
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
La página Scripting System – Form Designer del cuadro de diálogo Preferences

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