Cómo: Definir un elemento personalizado en un cuadro de herramientas de modelado

Para que le resulte más fácil crear un elemento o grupo de elementos con arreglo a un modelo que utilice habitualmente, puede agregar nuevas herramientas al cuadro de herramientas de los diagramas de modelado de Visual Studio Ultimate. Puede distribuir estos elementos del cuadro de herramientas a otros usuarios de Visual Studio Ultimate.

Por ejemplo, puede diseñar una herramienta personalizada para crear elementos como los siguientes:

• Un paquete vinculado al perfil de .NET y una clase con el estereotipo de .NET.

• Un par de clases vinculadas mediante una asociación que representen el modelo Observer.

Puede utilizar este método para crear herramientas de elementos. Es decir, puede crear herramientas que se arrastren desde el cuadro de herramientas a un diagrama. No se pueden crear herramientas de conectores.

Definir una herramienta de modelado personalizada

Para definir una herramienta de modelado personalizada

1. Cree un diagrama de UML que contenga un elemento o grupo de elementos.

   • Estos elementos pueden tener relaciones entre ellos y pueden tener elementos secundarios, como puertos, atributos, operaciones o pins.

   • En el Explorador de soluciones, cambie el nombre del diagrama por el nombre que desea asignar a la nueva herramienta.

2. Guarde el diagrama.

3. Con el Explorador de Windows, copie los dos archivos de diagrama en la carpeta que se indica a continuación o cualquier subcarpeta:

   SusDocumentos**\Visual Studio 2010\Architecture Tools\Custom Toolbox Items**

   • Cree esta carpeta, si es que no existe ya. Puede que tenga que crear Architecture Tools y Custom Toolbox Items.

   • Copie los dos archivos de diagrama, uno con un nombre terminado en "...diagram" y otro con un nombre terminado en "...diagram.layout"

   • Puede crear tantas herramientas personalizadas como desee. Utilice un diagrama para cada herramienta.

4. (Opcional) Cree un archivo .tbxinfo tal y como se describe en Definir las propiedades de las herramientas personalizadas y agréguelo al mismo directorio. De este modo, podrá definir un icono de cuadro de herramientas, una información sobre herramientas, etc.

   • Se puede utilizar un solo archivo .tbxinfo para definir varias herramientas. Aquí pueden establecerse las referencias a los archivos de diagrama que se encuentran en subcarpetas.

5. Reinicie Visual Studio. La herramienta adicional aparecerá en el cuadro de herramientas del tipo de diagrama adecuado.

Qué va a replicar la herramienta personalizada

Una herramienta personalizada replicará la mayoría de las características del diagrama de origen:

• Nombres. Cuando un elemento se crea a partir del cuadro de herramientas, se agrega un número al final del nombre si es necesario evitar que haya nombres duplicados en el mismo espacio de nombres.

• Colores, tamaños y formas

• Perfiles de estereotipos y paquetes

• Valores de propiedad, como Is Abstract

• Elementos de trabajo vinculados

• Multiplicidades y otras propiedades de relaciones

• Posiciones relativas de las formas.

Las siguientes características no se conservarán en una herramienta personalizada:

• Formas simples. Estas son formas que no están relacionadas con elementos del modelo, que puede dibujar en algunos tipos de diagramas.

• Enrutamiento de conectores. Si enruta conectores manualmente, no se conservará el enrutamiento cuando se use la herramienta. Las posiciones de algunas formas anidadas, como los Puertos, no se conservan con relación a sus propietarios.

Definir las propiedades de las herramientas personalizadas

Los archivos de información sobre el cuadro de herramientas (.tbxinfo) permiten especificar el nombre, el icono, la información sobre herramientas, la pestaña y la palabra clave del cuadro de herramientas de una o varias herramientas personalizadas. Dele cualquier nombre, por ejemplo MyTools.tbxinfo.

El formato general del archivo será similar al siguiente:

<?xml version="1.0" encoding="utf-8" ?>
<customToolboxItems xmlns="https://schemas.microsoft.com/visualstudio/2010/ArchitectureTools/CustomToolboxItems">
  <customToolboxItem fileName="MyObserverTool.classdiagram">
    <displayName>
       <value>Observer Pattern</value>
    </displayName>
    <tabName>
       <value>UML Class Diagram</value>
    </tabName>
    <image><bmp fileName="ObserverPatternIcon.bmp"/></image>
    <f1Keyword>
      <value>ObserverPatternHelp</value>
    </f1Keyword>
    <tooltip>
       <value>Create a pair of classes</value>
    </tooltip>
  </customToolboxItem>
</customToolboxItems>

El valor de cada elemento puede ser:

• Como se muestra en el ejemplo, <bmp fileName="…"/>para el icono de cuadro de herramientas y <value>string</value> para los demás elementos.

-O bien-

• <resource fileName="Resources.dll"

  baseName="Observer.resources" id="Observer.tabname" />

  En este caso, debe proporcionar un ensamblado compilado en el que los valores de cadena se hayan compilado como recursos.

Agregue un nodo <customToolboxItem> para cada elemento del cuadro de herramientas que desea definir.

Los nodos del archivo .tbxinfo son los siguientes. Hay un valor predeterminado para cada nodo.

Puede editar el archivo de mapa de bits en Visual Studio y establecer su alto y ancho en 16 a través de la ventana Propiedades.

Distribuir los elementos del cuadro de herramientas en una extensión de Visual Studio

Para distribuir los elementos del cuadro de herramientas a otros usuarios de Visual Studio, puede empaquetarlos en una extensión de Visual Studio (VSIX). Puede empaquetar comandos, perfiles y otras extensiones en el mismo archivo VSIX. Para obtener más información, vea Implementación de extensiones de Visual Studio.

La manera habitual de compilar una extensión de Visual Studio es utilizar la plantilla de proyecto de VSIX. Para ello, debe tener instalado Visual Studio SDK.

Para agregar un elemento del cuadro de herramientas a una extensión de Visual Studio

1. Cree y pruebe una o varias herramientas personalizadas.

2. Cree un archivo .tbxinfo que haga referencia a las herramientas.

3. Abra un proyecto de extensión de Visual Studio existente.

   -O bien-

   Defina un nuevo proyecto de extensión de Visual Studio.

   1. En el menú Archivo, elija Nuevo y, a continuación, haga clic en Proyecto.

   2. En el cuadro de diálogo Nuevo proyecto, en Plantillas instaladas, expanda Visual C#, haga clic en Extensibilidad y, a continuación, haga clic en Proyecto VSIX. Especifique el nombre del proyecto y haga clic en Aceptar.

4. Agregue sus definiciones del cuadro de herramientas al proyecto. Incluya el archivo .tbxinfo, los archivos de diagrama, los archivos de mapa de bits y cualquier archivo de recursos, y asegúrese de que se incluyen en la extensión VSIX.

   • En el Explorador de soluciones, haga clic con el botón secundario del mouse en el proyecto, elija Agregar y, a continuación, haga clic en Elemento existente. En el cuadro de diálogo, establezca Objetos de tipo: Todos los archivos. Busque los archivos, selecciónelos todos y, a continuación, haga clic en Agregar.

     Nota

     En este proyecto, los archivos de diagrama no se pueden abrir en el editor del modelo.

5. Establezca las siguientes propiedades de todos los archivos que acaba de agregar. Puede establecer sus propiedades al mismo tiempo seleccionándolos todos en el Explorador de soluciones. Tenga cuidado de no cambiar las propiedades de los demás archivos del proyecto.

   Copiar en el directorio de salida = Copiar siempre

   Acción de compilación = Contenido

   Incluir en VSIX = true

6. Abra source.extension.vsixmanifest. El archivo se abre en el editor de manifiestos de la extensión.

7. En Contenido, agregue una fila que describa las herramientas personalizadas. Haga clic en Agregar contenido y, a continuación, establezca los campos del diálogo como sigue:

   • Tipo de contenido = Tipo de extensión personalizada

   • Tipo = Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems

   • Ruta de acceso = Archivo del proyecto. Seleccione su archivo .tbxinfo, por ejemplo MyTools.tbxinfo

8. Puede establecer Product Name y los demás campos cuando desee.

9. Compile el proyecto.

10. En el Explorador de Windows, abra la carpeta .\bin\Debug o .\bin\Release para buscar el archivo .vsix. Es un archivo de la extensión de Visual Studio. Este archivo puede instalarse en el equipo y también enviarse a otros usuarios de Visual Studio.

Para instalar las herramientas personalizadas desde una extensión de Visual Studio

1. En el Explorador de Windows, haga doble clic en el archivo .vsix o ábralo en Visual Studio.

2. En el cuadro de diálogo que aparece, haga clic en Instalar.

3. Para desinstalar o deshabilitar temporalmente la extensión, abra el Administrador de extensiones en el menú Herramientas.

Localización

Puede realizar una extensión que, cuando se instale en otro equipo, muestre los nombres de herramienta y la información sobre herramientas en el idioma del equipo de destino.

Para proporcionar versiones de la herramienta en varios idiomas

1. Cree un proyecto de extensión de Visual Studio que contenga una o varias herramientas personalizadas.

   En el archivo .tbxinfo, utilice el método del archivo de recursos para definir la propiedad displayName de la herramienta, la propiedad tabName del cuadro de herramientas y la información sobre herramientas. Cree un archivo de recursos en el que se definan estas cadenas, compílelo en un ensamblado y establezca referencias a él en el archivo tbxinfo.

2. Cree ensamblados adicionales que contengan archivos de recursos con cadenas en otros idiomas.

3. Coloque cada ensamblado adicional en una carpeta cuyo nombre sea el código de referencia cultural del idioma. Por ejemplo, coloque una versión del ensamblado para el francés en una carpeta denominada fr.

4. Debe utilizar un código de referencia cultural neutro, normalmente dos letras, y no una referencia cultural concreta como fr-CA. Para obtener más información sobre los códigos de referencia cultural, vea CultureInfo.GetCultures method, donde se proporciona una lista completa de códigos de referencia cultural.

5. Compile la extensión de Visual Studio y distribúyala.

6. Cuando la extensión se instala en otro equipo, se carga automáticamente la versión del archivo de recursos de la referencia cultural local del usuario. Si no se proporciona ninguna versión para la referencia cultural del usuario, se utilizarán los recursos predeterminados.

No puede utilizar este método para instalar versiones diferentes del diagrama de prototipos. Los nombres de los elementos y conectores serán los mismos en cada instalación.

Otras operaciones del cuadro de herramientas

Por lo general, en Visual Studio se puede personalizar el cuadro de herramientas cambiando el nombre de las herramientas, moviéndolas a distintas pestañas y eliminándolas, pero estos cambios no se conservan en las herramientas de modelado personalizadas creadas con los procedimientos descritos en este tema. Cuando reinicie Visual Studio, las herramientas personalizadas volverán a aparecer con los nombres y las ubicaciones del cuadro de herramientas que se definieron.

Además, las herramientas personalizadas desaparecerán si ejecuta el comando Restablecer cuadro de herramientas. No obstante, volverán a aparecer cuando reinicie Visual Studio.

Vea también

Conceptos

Cómo: Definir un perfil para ampliar UML

Otros recursos

Ampliar modelos y diagramas UML

Cómo: Definir un comando de menú en un diagrama de modelado

Cómo: Definir restricciones de validación para modelos UML