Creación de scripts para componentes gráficos
De un vistazo
- Aprende a crear formularios de script y a añadir controles desde el panel Tool Palette.
- Descubre cómo inspeccionar propiedades, encontrar métodos y generar controladores de eventos para las interacciones del usuario.
- Comprende los ajustes que controlan la apariencia del formulario, el comportamiento de la ventana, la entrada del teclado y el foco inicial.
Esta referencia describe los componentes gráficos compatibles con la creación de scripts y sus principales propiedades y métodos.
Los componentes visuales de formulario disponibles para su uso en scripts de Altium Designer derivan en su mayoría de la biblioteca de componentes visuales (VCL) de Embarcadero, una colección de componentes visuales definidos para desarrollar aplicaciones de Windows con los lenguajes Delphi y C++.
Desarrollada como una biblioteca de clases visuales, las clases de la VCL descienden del objeto TComponent (a su vez, descendiente del objeto raíz TObject) en una jerarquía lineal de objetos. Por lo tanto, un componente de script común, como el objeto TButton, hereda las propiedades, los métodos y los eventos de sus objetos antecesores. En este caso, la jerarquía de clases es: TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.
Tenga en cuenta que los componentes que descienden del objeto TControl son generalmente componentes visuales (controles), y los componentes comunes que descienden de TWinControl son, en su mayoría, envoltorios de la API de Windows.
► Consulte VCL de Embarcadero RAD Studio para obtener una descripción general de la arquitectura y los componentes de la VCL.
Al crear un formulario en el editor de scripts de Altium Designer, se accede a los componentes desde el panel Tool Palette. Los formularios de script tienen un archivo *.DFM asociado que incluye detalles de la configuración del formulario, la ubicación de sus componentes y otros atributos; este archivo se encuentra en la carpeta que aloja el proyecto de script. Altium Designer permite utilizar los componentes tanto con DelphiScript como con VBScript al diseñar formularios de script.

El panel Tool Palette contiene controles visuales organizados por categorías que se pueden arrastrar a un formulario de script.
El panel Tool Palette contiene selecciones de componentes organizados por categorías que se pueden colocar en un formulario de script. Los componentes disponibles se agrupan en secciones expandibles en el panel Tool Palette, clasificadas como Estándar, Adicionales, Win32, Sistema, Cuadros de diálogo, Estándar de Altium y Controles de instrumentos.
Los componentes (o «controles») disponibles en la paleta son componentes visuales cuando se utilizan en un formulario de script, lo que significa que el usuario puede ver un control y, posiblemente, interactuar con él durante la ejecución. Todos los controles tienen propiedades, métodos y eventos que describen aspectos de su apariencia, como la propiedad de posición del control, métodos para dibujar o mover el control y eventos que responden a las acciones del usuario.
Las propiedades y los eventos están disponibles en el panel Object Inspector para el componente del formulario seleccionado en ese momento, incluido el propio formulario. Los métodos son procedimientos y funciones que admite ese componente.
Descripción general de los formularios de script
Formularios de script
Un formulario de script es la interfaz de usuario principal de los scripts, aunque existen otros tipos de formularios, como cuadros de diálogo, ventanas secundarias, etc. Para crear un nuevo formulario de script, con un proyecto abierto en Altium Designer, seleccione File » New » Script » Script Form o haga clic con el botón derecho en el nombre del proyecto de script y elija Add New to Project » Script Form. Si el lenguaje VBScript está habilitado, el comando estará disponible tanto para VB Script como para Delphi Script.
Aparece un nuevo formulario de script con el nombre de formulario predeterminado Form1, que se puede cambiar mediante la propiedad Name (en Misc) del panel Object Inspector. Los nombres de los formularios de script deben ser únicos dentro de un proyecto.
Al diseñar un formulario de script, abra el panel Object Inspector desde el botón Script de la barra de estado inferior.
Un formulario en blanco es básicamente una ventana visual a la que se pueden añadir controles. Un cuadro de diálogo y un panel son distintos tipos de formularios y, de forma predeterminada, un formulario incluye funciones estándar de ventana, como:
- Controles
- Botones para minimizar y maximizar
- Barra de título
- Cambio de tamaño arrastrando los bordes
Estas características, junto con cualquier otra propiedad disponible del formulario, se pueden cambiar durante el diseño mediante el panel Object Inspector. Dado que un formulario de script es un componente VCL, tiene los tres elementos siguientes:
-
Properties – Las características de un objeto que influyen en su comportamiento visible o en sus operaciones. Por ejemplo, la propiedad
Visibledetermina si un objeto se puede ver en un formulario de script. - Events – Acciones o sucesos detectados por el script. Un script debe incluir código para cada controlador de eventos, diseñado para capturar un evento específico, como un clic del ratón.
- Methods – Procedimientos de script asociados a objetos (en este caso, objetos de componente) que definen su comportamiento.
► Consulte Escritura de scripts para obtener una guía básica sobre el desarrollo de un script basado en formularios.
Propiedades, métodos y eventos del formulario
Los controles del panel Tool Palette se basan en la biblioteca de componentes visuales (VCL) de Embarcadero. Para obtener información detallada sobre los métodos, las propiedades y los eventos del componente de formulario (TForm), consulte la documentación de la VCL de Embarcadero.
► Consulte la referencia de TForm de Embarcadero
Propiedades de TForm
Las propiedades disponibles para el objeto de componente TForm, el formulario de script base, se pueden consultar de las siguientes maneras:
- A través del panel Object Inspector: en la vista de formulario del editor (con la pestaña Form seleccionada), haga clic en el cuerpo del propio formulario y seleccione la pestaña Object Inspector's Properties .
Tenga en cuenta que solo los objetos de componentes visuales aparecerán en el panel. Los objetos no visuales, que actúan como controles en segundo plano, no se muestran en el formulario.
- Mediante la función de autocompletado de código: en la vista de código del editor (con la pestaña Code seleccionada), la ventana de autocompletado de código sensible al contexto mostrará todas las opciones de código para el nombre de un objeto.
Para el objeto de formulario, introduzca TForm. (observe el punto) para activar la ventana. Acote la búsqueda escribiendo las primeras letras de la propiedad deseada; tenga en cuenta que se muestran tanto propiedades como métodos.
- En la documentación de referencia de Embarcadero, en la página de referencia de propiedades de TForm.
Métodos de TForm
Los métodos disponibles para el objeto de componente TForm se pueden consultar de las siguientes maneras:
- Mediante la función de autocompletado de código: en la vista de código del editor, escriba el nombre de un componente seguido de un punto. Se abrirá la ventana de autocompletado de código para mostrar los métodos (y las propiedades) del nombre de un objeto. Tenga en cuenta que la ventana de código se puede activar manualmente con el atajo de teclado Crtl+Space.
- Consulte la documentación de referencia de Embarcadero en la página de referencia de métodos de TForm. Tenga en cuenta que se muestran todos los métodos heredados, aunque esta opción se puede desactivar.
Eventos de TForm
Los eventos disponibles para el objeto de componente TForm se pueden consultar de las siguientes maneras:
- En el panel Object Inspector: en la vista de formulario del editor, haga clic en el cuerpo del propio formulario y seleccione la pestaña Events de Object Inspector.
- En la documentación de referencia de Embarcadero, en la página de referencia de eventos de TFrom.
Propiedades, eventos y métodos de los componentes
Los controles del panel Tool Palette se basan en la biblioteca de componentes visuales (VCL) de Embarcadero. Para obtener información detallada sobre los métodos, las propiedades y los eventos de la mayoría de los componentes, consulte las categorías de componentes en la documentación de la VCL de Embarcadero. Algunos tipos de componentes de Tool Palette, en particular los controles de instrumentos de Altium, son exclusivos de Altium Designer y no se incluyen en la documentación de referencia de Embarcadero.
► Consulte el índice de categorías de componentes VCL de Embarcadero
Propiedades de los componentes
Para ver una lista de las propiedades de un componente:
-
Seleccione un componente en el formulario y active la pestaña Properties del panel Object Inspector, como se muestra arriba para el objeto de componente
TForm. -
Seleccione el enlace Properties (en la parte superior) en la página de referencia del componente correspondiente de la documentación de referencia de Embarcadero. Por ejemplo, en el caso del control
TButton, seleccione la categoría Standard Component, la página TButton y, a continuación, la vista Properties.
Eventos de los componentes
Para ver una lista de los eventos a los que puede responder un componente:
-
Seleccione un componente en el formulario y active la pestaña Events del panel Object Inspector, como se muestra arriba para el objeto de componente
TForm. - Seleccione la página de referencia del componente correspondiente y, a continuación, su enlace Events en la documentación de referencia de Embarcadero. Tenga en cuenta que esto sirve como guía de los eventos disponibles para un componente y puede que no coincida plenamente con los eventos disponibles para los componentes de scripts de Altium Designer.
Para crear un procedimiento de gestión de eventos, elija en la pestaña Object Inspector Events el evento al que debe responder el componente y haga doble clic en el campo de entrada del evento. A continuación, se genera automáticamente en el script el procedimiento de gestión de eventos, cuyo nombre se forma a partir del componente y la acción del evento. Si se cambia el nombre del evento en el panel Object Inspector, el procedimiento de código correspondiente también cambia de nombre.
Métodos de los componentes
Consulte la documentación de categorías de componentes para obtener información sobre los métodos disponibles para un componente Tool Palette.
Esta incluye referencias para las siguientes categorías de objetos de control.
- Estándar
- Adicionales
- Win32
- Sistema
- Diálogo
- Estándar de Altium
- Controles de instrumentos
En su mayoría, estas categorías agrupan tipos de controles visuales de formularios basados en componentes VCL estándar de tipo Delphi. Las categorías Estándar de Altium y Controles de instrumentos son la excepción, ya que ofrecen componentes exclusivos del sistema de scripts de Altium Designer.
► Consulte las Tool Palette categorías de componentes.
Trabajo con formularios y componentes
Personalización de formularios de scripts
-
Para que un formulario permanezca por encima de otros paneles abiertos, por ejemplo, establezca la propiedad
FormStyleenfsStayOnTop. -
Para definir el comportamiento predeterminado de un formulario, establezca
FormKinden uno de los siguientes valores:fkNone, fkNormal, fkServerPanelofkModal.-
Si se selecciona
fkModal, el formulario será modal. Es decir, un formulario que espera la intervención del usuario antes de continuar con acciones como cerrar el formulario. -
Si se selecciona
fkServerPanel, el formulario se mostrará como un panel de servidor. -
Si se selecciona
fkNormal, el formulario actuará como un formulario normal no modal.
-
Si se selecciona
-
Para añadir o eliminar las barras de desplazamiento de un formulario, cambie el valor de las propiedades
HorzScrollBaryVertScrollBar. -
Para convertir el formulario en un marco o una ventana secundaria MDI (interfaz de múltiples documentos), utilice la propiedad
FormStyle. -
Para cambiar el estilo del borde de un formulario, utilice las propiedades
BorderIconsyBorderStyle. (Los resultados son visibles en tiempo de ejecución). -
Para cambiar el icono del formulario minimizado, utilice la propiedad
Icon. -
Para especificar la posición inicial de un formulario en la ventana de la aplicación, utilice la propiedad
Position. -
Para especificar el estado inicial de un formulario (por ejemplo, minimizado, maximizado o normal), utilice la propiedad
WindowState. -
Para definir el área de trabajo de un formulario en tiempo de ejecución, utilice las propiedades
ClientHeightyClientWidth. Tenga en cuenta queClientHeightyClientWidthrepresentan el área dentro del borde del formulario, mientras queHeightyWidthrepresentan el área completa del formulario. -
Para especificar qué control tiene el foco inicial en un formulario en tiempo de ejecución, utilice la propiedad
ActiveControlpara elegir entre los componentes disponibles. -
Para pasar todos los eventos del teclado a un formulario, independientemente del control seleccionado, utilice la propiedad
KeyPreview. -
Para especificar un menú concreto, si un formulario contiene más de un menú, utilice la propiedad
Menu.
Actualización de formularios y componentes
En algunos casos, el aspecto visual de un formulario de script puede quedar desactualizado; por ejemplo, si el procesamiento intensivo en segundo plano de un script impide que los controles se actualicen o se redibujen, y estos parecen bloqueados o dañados.
El método Update del formulario de script permite actualizar mediante programación el contenido gráfico de un formulario o de controles específicos. En el siguiente ejemplo de código, las líneas de código del método Update están resaltadas en gris.
Using the Update method to refresh the Status Bar:
Procedure TConverterForm.loadbuttonClick(Sender: TObject);
Var
I, J : Integer;
Begin
If OpenPictureDialog1.Execute then
Begin
XPProgressBar1.Position := 0;
XStatusBar1.SimpleText := ' Loading...';
XStatusBar1.Update;
// loading a monochrome bitmap only
Image1.Picture.LoadFromFile(OpenPictureDialog1.FileName);
// Check if image is monochrome, otherwise prompt a warning
If Image1.Picture.Bitmap.PixelFormat <> pf1bit Then
Begin
For J := 0 to Image1.Picture.Height – 1 Do
For I := 0 to Image1.Picture.Height – 1 Do
Begin
If Image1.Canvas.Pixels[I,J] <> clWhite Then
Image1.Canvas.Pixels[I,J] := clBlack;
End;
End;
ScalingFactorChange(Nil);
convertbutton.Enabled := True;
LoadButton.Enabled := False;
XStatusBar1.SimpleText := ' Ready...';
XStatusBar1.Update;
End;
End;
Consulte el proyecto de script PCB Logo Creator ubicado en la carpeta Scripts\Delphiscript Scripts\PCB\PCB Logo Creator de la colección de scripts descargable.



