Definición del complemento
Los parámetros que definen el aspecto de una secuencia de comandos, herramienta o complemento de objeto se almacenan en un registro de parámetros, que se asocia a cada instancia de objeto colocada en el archivo. Estos registros almacenan datos persistentes entre usos y proporcionan valores paramétricos por defecto. Un comando de menú que muestra un cuadro de diálogo, por ejemplo, puede necesitar almacenar valores introducidos por un usuario para su uso posterior. Una herramienta puede incluir varias opciones de modo en un cuadro emergente. Si el usuario desea seleccionar un modo diferente para la herramienta, el nuevo ajuste puede ser guardado y reutilizado en un uso posterior de la herramienta. Estos valores pueden almacenarse en el registro de parámetros del comando de menú o de la herramienta y recuperarse posteriormente cuando se vuelva a seleccionar el comando o la herramienta. Al cambiar de archivo, se mostrarán los valores almacenados asociados a los nuevos archivos o, si no existe ningún registro de parámetros, se mostrarán los valores por defecto del registro de parámetros creado por el elemento del complemento.
Los parámetros de cada instancia de objeto pueden modificarse utilizando la paleta Información del objeto para acceder a los valores del registro de parámetros del objeto. También se crea un registro de parámetros por defecto cuando se crea la primera instancia de un objeto (o herramienta) en el archivo. Este registro de parámetros por defecto, que es distinto de los registros de parámetros asociados a instancias de objetos, almacena los ajustes de configuración por defecto del objeto con el archivo. Se Utiliza cuando se colocan instancias de objetos posteriores para definir los valores predeterminados de cada nueva instancia de objeto.
Para definir el complemento personalizado:
En la pestaña Enchufes personalizados del Administrador de complementos, seleccione el enchufe que desea definir o editar.
Haga clic en Editar definición.
Se abre el cuadro de diálogo Editar definición del complemento.
Pulse aquí para mostrar u ocultar los parámetros.Pulse aquí para mostrar u ocultar los parámetros.
|
Parámetro |
Descripción |
|
Datos generales |
|
|
Tipo |
Muestra el tipo de complemento que se está creando (comando de menú, herramienta, objeto o archivo de inclusión) |
|
Lenguaje |
Muestra Python o VectorScript, en función del lenguaje utilizado para la parte de script del complemento (consulte Especificación de la secuencia de comandos del complemento). |
|
Nombre |
Especifica el nombre del nuevo complemento; también es el nombre del archivo del complemento, al que se añade automáticamente la extensión adecuada (.px, .vsm, .vst o .vso). Si cambia el nombre de un complemento, actualice después el espacio de trabajo para actualizar el nombre del enchufe. |
|
Categoría |
Asigna un complemento a una categoría de encabezamiento, para encontrar fácilmente el enchufe en el Editor del espacio de trabajo. |
|
Parámetros |
Especifica los parámetros por defecto del complemento. Los parámetros por defecto se aplican al complemento en el momento de la inserción. Los parámetros se incluyen en el orden especificado para el complemento; cambie el orden de los parámetros arrastrando dentro de la columna #. |
|
Lista de parámetros |
Incluye los parámetros por defecto del objeto, el nombre alternativo (localizado) si procede, el formato y el valor paramétrico por defecto. Para objetos lineales, se muestra el parámetro LineLength , que contiene la longitud del eje del objeto lineal. Para objetos rectangulares, se muestran los parámetros LineLength (la longitud inicial de la instancia del objeto) y BoxWidth (el ancho inicial de la instancia del objeto). Se pueden especificar nuevos valores por defecto para estos parámetros, pero no se pueden eliminar. |
|
Nuevo |
Abre el cuadro de diálogo Editar parámetro para crear un nuevo parámetro para el complemento. Especifique el nombre del parámetro, el nombre alternativo (localizado) si procede, el tipo y el valor por defecto. Para crear una lista emergente de opciones de parámetros predefinidos, seleccione el Tipo emergente . Se abre el cuadro de diálogo Editar opciones escogidas. Incluya las opciones en una lista. Cada línea del revestimiento incluye una opción escogida en la ventana emergente; no deje líneas en blanco. Para editar las opciones escogidas en la ventana emergente, haga clic en Opciones. |
|
Editar |
Abre el cuadro de diálogo Editar parámetro para editar el parámetro del complemento seleccionado. Algunos complementos externos e integrados permiten editar los parámetros. |
|
Eliminar |
Elimina el parámetro del complemento seleccionado. |
|
Especifica las cadenas de caracteres utilizadas por un complemento. |
|
|
Lista de categorías de caracteres |
Incluye las categorías de cadenas utilizadas por el complemento (por ejemplo, nombres de parámetros y botones para un cuadro de diálogo o cadenas de texto de ayuda). Dentro de cada categoría, especifique las cadenas de caracteres (por ejemplo, valores de selector de color que especifican un determinado color que debe utilizar el complemento). |
|
Abre el cuadro de diálogo Añadir categoría para añadir una categoría de cadena de caracteres a la definición del complemento. El siguiente número identificador de recurso disponible se asigna automáticamente; especifique el nombre de la categoría. Después de añadir una categoría, selecciónela y haga clic en Editar para añadirle líneas de texto. |
|
|
Editar |
Abre el cuadro de diálogo Editar cadenas para editar la categoría de cadenas elegida actualmente. Haga clic en Añadir para añadir una nueva cadena, o seleccione una cadena y haga clic en Editar o Quitar. El valor de cadena de texto depende de la categoría; para obtener más información, consulte developer.vectorworks.net. |
|
Eliminar |
Elimina la categoría actualmente seleccionada y todas sus cadenas de caracteres. |
|
Propiedades |
Los ajustes de propiedades permiten que los complementos se comporten como comandos de menú, herramientas y objetos estándar de Vectorworks. Estos ajustes controlan el comportamiento del complemento con respecto al estado del archivo (estado de selección, orientación de vista) así como definen el texto de ayuda a mostrar. Las Propiedades disponibles dependen del tipo de complemento. Sólo pueden especificarse propiedades personalizadas del complemento. |
|
Comando |
|
|
Opciones de disponibilidad |
Para cada estado de dibujo, especifique si la condición es obligatoria (la condición de estado de dibujo es necesaria para que el comando esté activo), prohibida (el comando se desactiva si existe la condición de estado de dibujo) o puede ignorarse (el estado de dibujo no afecta a la activación del comando). |
|
Información de herramienta Ayuda |
Especifica el texto de ayuda del comando de menú; el texto de ayuda que describe el comando de menú se muestra cuando el cursor se detiene sobre el comando (actualmente, esto sólo está disponible en Mac) |
|
Reemplazo de la Ayuda contextual |
Introducir una dirección URL (empezando por http:) para especificar una página de celosía que contenga información de ayuda. Para especificar un archivo relativo a la carpeta del programa Vectorworks, indique la ruta empezando por . / (punto y barra oblicua). |
|
Versión creada |
Especifica el número de versión de Vectorworks cuando se creó el complemento. Por ejemplo, para Vectorworks 2022, 2023 y 2024, use 27, 28 y 29 respectivamente. |
|
Versión Modificada |
Especifica el número de versión de Vectorworks cuando el complemento fue modificado por última vez. Por ejemplo, para Vectorworks 2022, 2023 y 2024 utilice 27, 28 y 29 respectivamente. |
|
Versión retirada |
Especifica el número de versión de Vectorworks cuando se retiró el complemento. Por ejemplo, para Vectorworks 2022, 2023 y 2024 utilice 27, 28 y 29 respectivamente. |
|
Herramienta |
|
|
Cadena de barra de herramienta |
Especifica el texto descriptivo a mostrar en la Barra de Herramientas; normalmente incluye el nombre del objeto, y puede incluir texto indicando una acción a realizar por el usuario. |
|
Icono |
Si lo desea, puede reemplazar el icono predeterminado del complemento por un icono personalizado. Con un editor de iconos de terceros, cree dos versiones del icono: una para una pantalla de resolución estándar y otra para una pantalla de alta resolución: Resolución estándar: una imagen centrada en un área de 26 píxeles de ancho por 20 píxeles de alto. Guardar el icono en formato .png. Alta resolución: una imagen centrada en un área de 52 píxeles de ancho por 40 píxeles de alto. Guarde el icono en formato .png con el mismo nombre que la imagen de resolución estándar con "@2x" añadido al final del nombre del archivo. Por ejemplo, si el icono de resolución estándar se llama 3DModelingToolSet.png, el icono de alta resolución debe llamarse 3DModelingToolSet@2x.png; de lo contrario, el programa no podrá localizar el icono. Haga clic en Importar icono PNG para importar el icono de resolución estándar; si también hay un icono de alta resolución con la designación @2x, el programa también lo importará automáticamente. El programa Vectorworks muestra automáticamente la imagen apropiada para la resolución del Dispositivo. |
|
Proyecto |
Determina qué proyección cartográfica debe estar activa. Si se requiere proyección 3D, se cambia la vista. Si se requiere proyección 2D, se activa el plano de capa para la herramienta. La proyección híbrida no afecta a la proyección cartográfica. |
|
Ejecutar secuencia de comandos |
Las herramientas están configuradas por defecto para ejecutarse inmediatamente cuando se seleccionan. En algunos casos, sin embargo, puede ser deseable que la ejecución de comandos espere al movimiento del ratón (como una herramienta que dibuja interactivamente basándose en el movimiento del ratón del usuario). |
|
Reemplazo de la Ayuda contextual |
Introducir una dirección URL (empezando por http:) para especificar una página de celosía que contenga información de ayuda. Para especificar un archivo relativo a la carpeta del programa Vectorworks, indique la ruta empezando por . / (punto y barra oblicua). |
|
Versión creada |
Especifica el número de versión de Vectorworks cuando se creó el complemento. Por ejemplo, para Vectorworks 2022, 2023 y 2024, use 27, 28 y 29 respectivamente. |
|
Versión Modificada |
Especifica el número de versión de Vectorworks cuando el complemento fue modificado por última vez. Por ejemplo, para Vectorworks 2022, 2023 y 2024 utilice 27, 28 y 29 respectivamente. |
|
Versión retirada |
Especifica el número de versión de Vectorworks cuando se retiró el complemento. Por ejemplo, para Vectorworks 2022, 2023 y 2024 utilice 27, 28 y 29 respectivamente. |
|
Información de herramienta Ayuda |
Especifica el texto de ayuda que se mostrará cuando el cursor se detenga sobre el icono del objeto en una paleta. |
|
Objeto |
|
|
Icono |
Si lo desea, puede reemplazar el icono predeterminado por un icono personalizado. Con un editor de iconos de terceros, cree una imagen de 8 bits, centrada en un área de 26 píxeles de ancho por 20 píxeles de alto. Guarde el icono en formato .png y haga clic en Importar icono PNG para importarlo. |
|
Proyección |
Determina qué proyección cartográfica de la vista debe estar activa. Si se requiere proyección 3D, se cambia la vista. Si se requiere proyección 2D, se activa el plano de capa para la herramienta. La proyección híbrida no afecta a la proyección cartográfica. |
|
Ejecutar secuencia de comandos |
Los objetos están configurados por defecto para ejecutarse inmediatamente cuando se seleccionan. En algunos casos, sin embargo, puede ser deseable que la ejecución de comandos espere al movimiento del ratón (como un objeto que dibuja interactivamente basándose en el movimiento del ratón del usuario). |
|
Clase por defecto |
Especifica la clase por defecto para el objeto en el momento de la inserción; si la clase no existe cuando se coloca el objeto, la clase se autogenera. |
|
Sustitución de la Ayuda contextual |
Introducir una dirección URL (empezando por http:) para especificar una página de celosía que contenga información de ayuda. Para especificar un archivo relativo a la carpeta del programa Vectorworks, indique la ruta empezando por . / (punto y barra oblicua). |
|
Versión creada |
Especifica el número de versión de Vectorworks cuando se creó el complemento. Por ejemplo, para Vectorworks 2022, 2023 y 2024, use 27, 28 y 29 respectivamente. |
|
Versión Modificada |
Especifica el número de versión de Vectorworks cuando el complemento fue modificado por última vez. Por ejemplo, para Vectorworks 2022, 2023 y 2024 utilice 27, 28 y 29 respectivamente. |
|
Versión retirada |
Especifica el número de versión de Vectorworks cuando se retiró el complemento. Por ejemplo, para Vectorworks 2022, 2023 y 2024 utilice 27, 28 y 29 respectivamente. |
|
Información de herramienta Ayuda |
Especifica el texto de ayuda que se mostrará cuando el cursor se detenga sobre el icono del objeto en una paleta. |
|
Subpartes |
Especifica los subapartados utilizados en el complemento. |
|
Lista de subpartidas |
Incluye cada subparte y su nombre alternativo (localizado) si procede. |
|
Añade un nuevo nombre de subparte para el complemento. Se abre el cuadro de diálogo Añadir nombre de subparte. Especifique el nombre del parámetro y un nombre alternativo (localizado) si procede. |
|
|
Editar |
Edita el nombre de subparte seleccionado. |
|
Eliminar |
Elimina el nombre de subparte seleccionado. |
|
Opciones (sólo tipos de objetos paramétricos personalizados) |
|
|
Opciones de ejecución |
A los objetos, como a los símbolos, se les pueden asignar opciones de inserción predefinidas para la colocación de documentos. Estas opciones permiten que los objetos interactúen correctamente con muros u otros tipos de objetos avanzados de Vectorworks. Los complementos de comandos y herramientas no tienen ajustes de opciones de inserción. Por defecto, la geometría del objeto sólo se recalculará si se editan los parámetros del objeto o los puntos de control. Cuando la geometría del objeto es recalculada, los ajustes de configuración por defecto para atributos como fuente, tamaño de letra o color de línea serán reaplicados al objeto. Si alguno de estos ajustes ha sido modificado desde que el objeto fue colocado o editado por última vez, pueden producirse cambios en la apariencia del objeto. La secuencia de comandos se ejecuta cada vez que cambian los parámetros del objeto. Además, para las instancias en las que es importante que el objeto se recalcule (por ejemplo, ventanas colocadas en una pared), la secuencia de comandos puede hacer que la geometría se recalcule cuando el objeto se gira (Restablecer al Rotar) o se mueve (Restablecer al Mover). Alternativamente, el script del complemento puede convertirse en un manejador de eventos (Basado en Eventos); los scripts deben entonces responder a un pequeño conjunto de eventos de la aplicación. Para muestreo y documentación sobre secuencias de comandos de manejo de eventos, acceda al área de Soporte en vectorworks.net. |
|
Insertar en Pared |
Consulte Crear definiciones de símbolo. Para los objetos que no requieren opciones de inserción, deje las opciones en los ajustes de configuración predeterminados. |
Una vez definido el complemento, haga clic en Aceptar para volver al Administrador de complementos.
