Definición del complemento
Los parámetros que definen la apariencia de un comando con secuencia de comandos, una herramienta o un objeto de complemento se almacenan en un registro de parámetros que se asocia con cada instancia de objeto fijada en el archivo. Estos registros almacenan datos persistentes entre usos y brindan valores de parámetros predeterminados. Un comando de menú que muestre un cuadro de diálogo, por ejemplo, puede necesitar almacenar valores introducidos por un usuario para usarlos con posterioridad. Una herramienta puede ofrecer varias opciones de modo en una lista emergente. Si el usuario desea seleccionar un modo diferente para la herramienta, la nueva configuración se puede guardar y reutilizar cuando se use el elemento de herramienta con posterioridad. Estos valores se pueden almacenar en el registro de parámetros del comando de menú o la herramienta, y se pueden recuperar cuando el comando o la herramienta se seleccionen de nuevo. Alternar archivos mostrará los valores almacenados relacionados con los nuevos archivos o bien, si no existe ningún registro de parámetros, se mostrarán los valores predeterminados del registro de parámetros según se crearon en el elemento de complemento.
Los parámetros de cada instancia de objeto se pueden modificar mediante la paleta Información del objeto para obtener acceso a los valores del registro de parámetros de objetos. Un registro de parámetros predeterminados también se crea cuando se crea en el archivo la primera instancia de un objeto (o una herramienta). Este registro de parámetros predeterminados, que es diferente de los registros de parámetros relacionados con instancias de objetos, almacena la configuración predeterminada del objeto con el archivo. Se usa al colocar instancias de objeto posteriores para definir los valores predeterminados para cada nueva instancia de objeto.
Para definir los parámetros de complemento personalizados:
Desde la pestaña Complementos personalizados del Administrador de complementos, seleccione el complemento que desee definir o editar.
Pulse Editar definición.
Se abre el cuadro de diálogo Editar definición de 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 incluido) |
|
Lenguaje |
Muestra Python o VectorScript, según el lenguaje usado para la porción de la secuencia de comandos del complemento (ver Confección de la secuencia de comandos del complemento) |
|
Nombre |
Especifica el nombre del nuevo complemento; este también es el nombre del archivo de complemento y es automáticamente anexado con la extensión adecuada (.px, .vsm, .vst o .vso). Si se cambia el nombre de un complemento, actualizar el espacio de trabajo posteriormente para actualizar el nombre del complemento. |
|
Categoría |
Asigna un complemento a una categoría de título, para buscar con facilidad el complemento en el Editor de espacio de trabajo |
|
Parámetros |
Especifica los parámetros predeterminados para el complemento. Los parámetros predeterminados se aplican al complemento durante la inserción. Los parámetros se enumeran en el orden especificado para el complemento; cambiar el orden de los parámetros arrastrándolos dentro del núm. de columna. |
|
Lista de parámetros |
Enumera los parámetros de objeto predeterminados, el nombre alternativo (localizado) si corresponde, el formato y el valor predeterminado. En el caso de los objetos lineales, aparece el parámetro LineLength, que contiene la longitud del eje del objeto lineal. En el caso de los objetos rectangulares, aparecen en pantalla los parámetros LineLength (la longitud inicial de la instancia del objeto) y BoxWidth (el ancho inicial de la instancia del objeto). Los nuevos valores predeterminados se pueden especificar para estos parámetros, pero no se pueden eliminar. |
|
Nuevo |
Crea un nuevo parámetro para el complemento. Se abre el cuadro de diálogo Editar parámetro. Especificar el nombre de parámetro, nombre alternativo (localizado) si corresponde, tipo y valor predeterminado. Para crear una lista de elementos emergentes de opciones de parámetros predefinido, seleccione Tipo de Elemento emergente. Se abre el cuadro de diálogo Editar opciones. Enumere las opciones; cada línea de la lista representa una opción en la lista emergente. No deje ninguna línea en blanco. Para editar las opciones de la lista emergente, pulse Opciones. |
|
Editar |
El parámetro edita el parámetro de complemento seleccionado. Determinados complementos integrados y de terceros permiten la edición de parámetros. |
|
Eliminar |
Elimina el parámetro de complemento seleccionado |
|
Especifica las cadenas de texto usadas por un complemento |
|
|
Lista de cadenas de texto |
Enumera las cadenas de texto usadas por el complemento (por ejemplo, los valores del selector de colores que especificar un color determinado que deberá usar el complemento) |
|
Agrega una cadena de texto a la definición del complemento. Se abre el cuadro de diálogo Agregar categoría. El siguiente número identificador del recurso disponible se asigna automáticamente; indique el nombre de categoría. |
|
|
Editar |
Edita la cadena de texto actualmente seleccionada. Se abre el cuadro de diálogo Editar cadenas de textos. Seleccione el valor de la cadena de texto individual y pulse Editar para abrir el cuadro de diálogo Editar cadena de texto. Especificar el valor de la cadena de texto; el valor depende de la categoría; para mas información, ver developer.vectorworks.net. |
|
Eliminar |
Elimina la cadena de texto actualmente seleccionada |
|
Propiedades |
La configuración de propiedades permite que los complementos se comporten como comandos de menú, herramientas y objetos de Vectorworks estándar. Esta configuración controla el comportamiento del complemento con respecto al estado del archivo (estado de selección, orientación de la vista), así como también define el texto de ayuda que aparecerá en pantalla. Las propiedades disponibles dependen del tipo de complemento. Solo se pueden especificar propiedades de complemento personalizadas. |
|
Comando |
|
|
Opciones de disponibilidad |
Para cada estado de dibujo, especificar si la condición es obligatoria (la condición de estado del dibujo es necesaria para que el comando esté activo), prohibida (el comando se desactiva si se encuentra la condición de estado de dibujo) o puede ser omitida (el estado del dibujo no afecta la activación del comando) |
|
Ayuda de información de herramientas |
Especifica el texto de ayuda del comando de menú; el texto de ayuda que describe el comando de menú aparece en pantalla cuando el cursor se detiene sobre el comando (actualmente, esta opción solo está disponible en Mac) |
|
Superponer ayuda contextual |
Introducir una URL (que comience con http:) para especificar una página web que contenga información de ayuda. Para especificar un archivo relativo a la carpeta del programa Vectorworks, indicar el trazado de acceso con . / (punto y barra invertida). |
|
Versión creada |
Especifica el número de versión de Vectorworks correspondiente al momento en que se creó el complemento. Por ejemplo, usar 24, 25 y 26 para Vectorworks 2019, 2020 y 2021, respectivamente. |
|
Versión modificada |
Especifica el número de versión de Vectorworks correspondiente al momento en que se modificó por última vez el complemento. Por ejemplo, usar 24, 25 y 26 para Vectorworks 2019, 2020 y 2021, respectivamente. |
|
Versión retirada |
Especifica el número de versión de Vectorworks correspondiente al momento en que se retiró el complemento. Por ejemplo, usar 24, 25 y 26 para Vectorworks 2019, 2020 y 2021, respectivamente. |
|
Herramienta |
|
|
Texto de la barra de herramientas |
Especifica el texto descriptivo que aparecerá en la barra de herramientas; normalmente esto incluye el nombre del objeto y puede incluir texto que indique una acción que deberá realizar el usuario |
|
Icono |
El icono predeterminado para el complemento se puede reemplazar por un icono personalizado, si se desea. Use un editor de iconos de un tercero proveedor para crear dos versiones del icono: uno para la presentación de resolución estándar y otro para la presentación de gran 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. Guardar el icono en formato .png con el mismo nombre que la imagen de resolución estándar y con “@2x” anexado al final del nombre del archivo. Por ejemplo, si el icono de resolución estándar se denomina 3DModelingToolSet.png, el icono de alta resolución se deberá llamar 3DModelingToolSet@2x.png; de lo contrario el programa Vectorworks no podrá encontrar el icono. Hacer clic en Importar icono PNG para importar el icono de resolución estándar. Si también se encuentra presente un icono de alta resolución con la designación @2x, el software también lo importará de forma automática. El programa Vectorworks automáticamente muestra la imagen correspondiente según la resolución del dispositivo. |
|
Proyección |
Determina qué proyección de vista debe estar activa. Si se necesita una proyección 3D, se cambia la vista. Si se necesita una proyección 2D, se activa el Plano de pantalla para la herramienta. La proyección híbrida no afecta la proyección de la vista. |
|
Ejecutar secuencia de comandos |
Las herramientas están configuradas de manera predeterminada para que se ejecuten de inmediato cuando se seleccionen. Sin embargo, en algunos casos, puede resultar recomendable indicar que la secuencia de comandos no se ejecute hasta que se mueva el ratón (como una herramienta que dibuje de forma interactiva según el movimiento que el usuario realice con el ratón). |
|
Superponer ayuda contextual |
Introducir una URL (que comience con http:) para especificar una página web que contenga información de ayuda. Para especificar un archivo relativo a la carpeta del programa Vectorworks, indicar el trazado de acceso con . / (punto y barra invertida). |
|
Versión creada |
Especifica el número de versión de Vectorworks correspondiente al momento en que se creó el complemento. Por ejemplo, usar 24, 25 y 26 para Vectorworks 2019, 2020 y 2021, respectivamente. |
|
Versión modificada |
Especifica el número de versión de Vectorworks correspondiente al momento en que se modificó por última vez el complemento. Por ejemplo, usar 24, 25 y 26 para Vectorworks 2019, 2020 y 2021, respectivamente. |
|
Versión retirada |
Especifica el número de versión de Vectorworks correspondiente al momento en que se retiró el complemento. Por ejemplo, usar 24, 25 y 26 para Vectorworks 2019, 2020 y 2021, respectivamente. |
|
Ayuda de información de herramientas |
Especifica el texto de ayuda que aparecerá en pantalla cuando el cursor se detenga por encima del icono del objeto de una paleta. |
|
Objeto |
|
|
Icono |
El icono predeterminado se puede reemplazar por un icono personalizado, si se desea. Con un editor de icono de terceros, crear una imagen de 8 bits, centrada en un área de 26 píxeles de ancho por 20 píxeles de alto. Guardar el icono en formato .png y hacer clic en Importar icono PNG para importarlo. |
|
Proyección |
Determina qué proyección de vista debe estar activa. Si se necesita una proyección 3D, se cambia la vista. Si se necesita una proyección 2D, se activa el Plano de pantalla para la herramienta. La proyección híbrida no afecta la proyección de la vista. |
|
Ejecutar secuencia de comandos |
Los objetos están configurados de manera predeterminada para que se ejecuten de inmediato cuando se seleccionen. Sin embargo, en algunos casos, puede resultar recomendable indicar que la secuencia de comandos no se ejecute hasta que se mueva el ratón (como un objeto que dibuje de forma interactiva según el movimiento que el usuario realice con el ratón). |
|
Clase predeterminada |
Especifica la clase predeterminada para el objeto durante la inserción; si la clase no existe cuando se fija el objeto, esta se crea automáticamente. |
|
Superponer ayuda contextual |
Escriba una dirección URL que comience con http: para indicar la página web que contendrá la información de ayuda. Para especificar un archivo relativo a la carpeta del programa Vectorworks, indicar el trazado de acceso con . / (punto y barra invertida). |
|
Versión creada |
Especifica el número de versión de Vectorworks correspondiente al momento en que se creó el complemento. Por ejemplo, usar 24, 25 y 26 para Vectorworks 2019, 2020 y 2021, respectivamente. |
|
Versión modificada |
Especifica el número de versión de Vectorworks correspondiente al momento en que se modificó por última vez el complemento. Por ejemplo, usar 24, 25 y 26 para Vectorworks 2019, 2020 y 2021, respectivamente. |
|
Versión retirada |
Especifica el número de versión de Vectorworks correspondiente al momento en que se retiró el complemento. Por ejemplo, usar 24, 25 y 26 para Vectorworks 2019, 2020 y 2021, respectivamente. |
|
Ayuda de información de herramientas |
Especifica el texto de ayuda que aparecerá en pantalla cuando el cursor se detenga por encima del icono del objeto de una paleta. |
|
Opciones (solo tipos de objetos paramétricos personalizados) |
|
|
Opciones de ejecución |
A los objetos, tales como símbolos, se les puede asignar opciones de inserción predefinidas para la colocación en el documento. Estas opciones permiten que lo objetos interactúen correctamente con las paredes y otros tipos de objeto avanzados de Vectorworks. Los complementos de comandos y herramientas no poseen configuración de opciones de inserción. De manera predeterminada, la geometría del objeto únicamente se recalculará si los parámetros del objeto o los puntos de control se editan. Cuando se recalcula la geometría del objeto, se volverán a aplicar al objeto parámetros de configuración predeterminados del archivo para atributos tales como fuente, tamaño de texto o color de línea. Si cualquiera de estos valores de configuración se modificó desde que se fijó el objeto o se editó por última vez, pueden producirse cambios en la apariencia del objeto. Se ejecuta la secuencia de comandos cada vez que cambian los parámetros del objeto. Además, en el caso de las instancias en que resulta importante que se recalcule el objeto (por ejemplo, se fija una ventana sobre una pared), la secuencia de comandos puede hacer que se recalcule la geometría cuando se gire (Restablecer al girar) o se mueva el objeto (Restablecer al mover). Como alternativa, la secuencia de comandos del complemento puede transformarse en un controlador de eventos (Basado en eventos); las secuencias de comandos deben responder entonces a un conjunto pequeño de eventos de aplicación. Para obtener muestras y documentación sobre las secuencias de comandos controladoras de eventos, acceda al área de Asistencia en www.vectorworks.net. |
|
Insertar en paredes |
Seleccionar la configuración de opciones de inserción para el objeto. Consulte las instrucciones pertinentes en el tema Creación de definiciones de símbolo. Para objetos que no requieren opciones de inserción, dejar las opciones como configuración predeterminada. |
Cuando los parámetros de complemento se hayan definido, pulse Aceptar para volver al Administrador de complementos.
