Definición de complementos

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 fijar instancias de objeto posteriores para definir los valores predeterminados para cada nueva instancia de objeto.

Para definir los parámetros de complemento personalizados:

1. Desde la ficha Complementos personalizados del Administrador de complementos, seleccione el complemento que desee definir o editar.

2. Haga clic en Editar definición.

Se abrirá el cuadro de diálogo Editar definición de complemento.

Haga clic para mostrar/ocultar los parámetros.

Parámetro	Descripción
General
Tipo	Muestra el tipo de complemento que se está creando (comando de menú, herramienta, objeto o archivo incluido).
Lenguaje	Muestra Python o VectorScript, de acuerdo con el lenguaje usado para la porción de la secuencia de comandos del complemento (ver Especificar la secuencia de comandos del complemento).
Nombre	Especifica el nombre del nuevo complemento; este también es el nombre del archivo de complemento, automáticamente anexado con la extensión correspondiente (.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 Longituddelínea, que contiene la longitud del eje del objeto lineal. En el caso de los objetos rectangulares, aparecen en pantalla los parámetros Longituddelínea (la longitud inicial de la instancia del objeto) y Anchodecuadro (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 abrirá el cuadro de diálogo Editar parámetros. Especificar el nombre del parámetro, el nombre alternativo (localizado) si corresponde, el tipo y el valor predeterminado; y hacer clic en OK para crear el parámetro de complemento. Para crear una lista de elementos emergentes de opciones de parámetros pre-definido, seleccione Tipo de Elemento emergente. Se abrirá el cuadro de diálogo Editar opciones. Enumere las opciones; cada línea en la lista representa una opción en el elemento emergente. Haga clic en OK. Para editar las opciones del elemento emergente haga clic en Opciones.
Editar	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.
Cadenas de texto	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).
Agregar	Agrega una cadena de texto a la definición del complemento. Se abrirá el cuadro de diálogo Agregar categoría. El siguiente Número de identificación del recurso disponible se asigna automáticamente; especificar el nombre de la categoría y hacer clic en OK.
Editar	Edita la cadena de texto actualmente seleccionada. Se abrirá el cuadro de diálogo Editar cadenas de textos. Seleccionar el valor de la cadena de texto individual y hacer clic en Editar para abrir el cuadro de diálogo Editar cadena de texto. Especificar el valor de la cadena de texto y luego, hacer clic en OK; el valor depende de la categoría. Para obtener información, ver http://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 la ruta 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, Vectorworks 2014, 2015 y 2016, usar 19, 20 y 21, 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, Vectorworks 2014, 2015 y 2016, usar 19, 20 y 21, respectivamente.
Versión retirada	Especifica el número de versión de Vectorworks correspondiente al momento en que se retiró el complemento. Por ejemplo, Vectorworks 2014, 2015 y 2016, usar 19, 20 y 21, 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. Mediante un editor de iconos de una tercera parte, crear dos versiones del icono; una para la resolución estándar y otra para una 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. 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 mouse (como una herramienta que dibuje de forma interactiva según el movimiento que el usuario realice con el mouse).
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 la ruta 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, Vectorworks 2014, 2015 y 2016, usar 19, 20 y 21, 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, Vectorworks 2014, 2015 y 2016, usar 19, 20 y 21, respectivamente.
Versión retirada	Especifica el número de versión de Vectorworks correspondiente al momento en que se retiró el complemento. Por ejemplo, Vectorworks 2014, 2015 y 2016, usar 19, 20 y 21, 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 mouse (como un objeto que dibuje de forma interactiva según el movimiento que el usuario realice con el mouse).
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	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 la ruta 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, Vectorworks 2014, 2015 y 2016, usar 19, 20 y 21, 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, Vectorworks 2014, 2015 y 2016, usar 19, 20 y 21, respectivamente.
Versión retirada	Especifica el número de versión de Vectorworks correspondiente al momento en que se retiró el complemento. Por ejemplo, Vectorworks 2014, 2015 y 2016, usar 19, 20 y 21, 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 secuencia de comandos controladoras de eventos, acceder al área Asistencia en www.vectorworks.net.
Insertar en paredes	Seleccionar la configuración de opciones de inserción para el objeto. Ver Crear símbolos nuevos. Para objetos que no requieren opciones de inserción, dejar las opciones como configuración predeterminada.

3. Cuando los parámetros de complemento se hayan definido, haga clic en OK para volver al Administrador de complementos.

~~~~~~~~~~~~~~~~~~~~~~~~~

Especificar la secuencia de comandos del complemento

Especificar la definición del complemento

Complementos con secuencias de comandos

vectorworks.net/espanol