Como: Definir um Item da caixa de ferramentas de modelagem de personalizado

Artigo
08/08/2011

Para tornar fácil criar um elemento ou grupo de elementos de acordo com um padrão que são freqüentemente usados, você pode adicionar novas ferramentas para a caixa de ferramentas de modelagem de diagramas no Visual Studio Ultimate. Você pode distribuir esses itens de caixa de ferramentas para outros Visual Studio Ultimate os usuários.

Por exemplo, você pode fazer uma ferramenta personalizada para criar elementos como estes:

Um pacote vinculado a.O perfil de rede e uma classe com o.NET estereótipo.
Um par de classes vinculadas por uma associação para representar o padrão Observer.

Você pode usar esse método para criar ferramentas de elemento. Ou seja, você pode criar ferramentas que você arraste da toolbox em um diagrama. Não é possível criar ferramentas de conector.

A definição de uma ferramenta de modelagem de personalizada

Para definir uma ferramenta de modelagem personalizadas

Crie um diagrama UML que contém um elemento ou grupo de elementos.
- Esses elementos podem ter relacionamentos entre eles e podem ter a subsidiária elementos como, por exemplo, portas, atributos, operações ou pinos.
- No Solution Explorer, altere o nome do diagrama para o nome que você deseja dar a nova ferramenta.
Salve o diagrama.
Usando o Windows Explorer, copie os arquivos de diagrama de dois para a seguinte pasta ou qualquer subpasta:

YourDocuments**\Visual Studio 2010\Architecture Tools\Custom Toolbox Items**
- Se ainda não existir, crie essa pasta. Talvez você precise criar ambos Architecture Tools e Custom Toolbox Items.
- Copiar ambos os arquivos de diagrama, um com um nome que termina com "…diagram" e outro com um nome que termina com "…diagram.layout"
- Você pode fazer quantas ferramentas personalizadas, como desejar. Use um diagrama para cada ferramenta.
(Opcional) Criar um .tbxinfo arquivo conforme descrito em como definir as propriedades de ferramentas personalizadae adicioná-lo no mesmo diretório. Isso permite que você definir um ícone da caixa de ferramentas, dica de ferramenta e assim por diante.
- Um único .tbxinfo arquivo pode ser usado para definir várias ferramentas. Ele pode se referir aos arquivos de diagrama que estão em subpastas.
Reinicie Visual Studio. A ferramenta adicional aparecerá na caixa de ferramentas para o tipo apropriado de diagrama.

O que a ferramenta personalizada replicará

Uma ferramenta personalizada replicará a maioria dos recursos do diagrama de origem:

Nomes. Quando um item é criado na caixa de ferramentas, um número é adicionado ao final do nome, se necessário, para evitar nomes duplicados no mesmo namespace.
Formas, tamanhos e cores
Estereótipos e perfis de pacote
Valores de propriedade como, por exemplo, É abstrata
Itens de trabalho vinculadas
Multiplicidades e outras propriedades de relações
As posições relativas das formas.

Os seguintes recursos não serão preservados em uma ferramenta personalizada:

Formas simples. Estas são as formas que não estão relacionados aos elementos de modelo que você pode desenhar em alguns tipos de diagramas.
Roteamento de conector. Se você circular conectores manualmente, o roteamento não será preservado quando a ferramenta é usada. As posições de algumas formas aninhadas, como, por exemplo, portas, não são preservadas em relação a seus proprietários.

Como definir as propriedades personalizadas de ferramentas

Informações de uma caixa de ferramentas (.tbxinfo) arquivo permite que você especifique um nome de caixa de ferramentas, o ícone, a dica de ferramenta, a guia e ajuda a palavra-chave para ferramentas personalizadas um ou mais. Atribua o nome, como MyTools.tbxinfo.

A forma geral do arquivo é o seguinte:

<?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>

O valor de cada item pode ser:

Conforme mostrado no exemplo, <bmp fileName="…"/> para o ícone da caixa de ferramentas e <value>string</value> para outros itens.

- ou -

<resource fileName="Resources.dll"

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

Nesse caso, você pode fornecer um assembly compilado no qual os valores de string foram compilados como recursos.

Adicionar um <customToolboxItem> o nó para cada item de caixa de ferramentas que você deseja definir.

Nós o .tbxinfo arquivo são como segue: Há um valor padrão para cada nó.

Nome do nó	Define
displayName	O nome do item da caixa de ferramentas.
tabName	Na guia toolbox na qual o item deve aparecer. Você pode especificar o nome da guia regular para este tipo de diagrama ou um nome diferente.
imagem	O local do bitmap (.bmp) o arquivo, que deve ter altura e largura de 16 e uma profundidade de cores de 24 bits.
f1Keyword	A palavra-chave que localiza um tópico da Ajuda.
Dica de ferramenta	Uma dica de ferramenta para essa ferramenta.

Você pode editar o arquivo de bitmap no Visual Studio e definir sua altura e largura a 16 na janela Propriedades.

Observação
Se você começar a usar um arquivo de .tbxinfo depois de testar usando arquivos de diagrama por conta própria, você pode achar que a caixa de ferramentas contém tanto as antigas e novas versões de um item da caixa de ferramentas. Isso também pode ocorrer se o nome do arquivo de diagrama foi digitado incorretamente no arquivo .tbxinfo. Se isso ocorrer, o direito de um item da caixa de ferramentas e clique Redefinir caixa de ferramentas. Os itens da caixa de ferramentas personalizada desaparecerão. Reinicie o Visual Studio e os itens personalizados corretos serão exibido.

Se você começar a usar um arquivo de .tbxinfo depois de testar usando arquivos de diagrama por conta própria, você pode achar que a caixa de ferramentas contém tanto as antigas e novas versões de um item da caixa de ferramentas. Isso também pode ocorrer se o nome do arquivo de diagrama foi digitado incorretamente no arquivo .tbxinfo. Se isso ocorrer, o direito de um item da caixa de ferramentas e clique Redefinir caixa de ferramentas. Os itens da caixa de ferramentas personalizada desaparecerão. Reinicie o Visual Studio e os itens personalizados corretos serão exibido.

Como distribuir os itens da caixa de ferramentas em uma extensão de Visual Studio

Você pode distribuir os itens de caixa de ferramentas para outra Visual Studio usuários compactando-os em uma extensão de Visual Studio (VSIX). Você pode empacotar os comandos, perfis e outras extensões no mesmo arquivo VSIX. Para obter mais informações, consulte Implantação de extensões de Visual Studio.

A maneira usual de criar uma extensão de Visual Studio é usar o modelo de projeto VSIX. Para fazer isso, você deve ter instalado SDK do Visual Studio.

Para adicionar um Item de caixa de ferramentas para uma extensão de Visual Studio

Criar e testar ferramentas personalizadas de um ou mais.
Criar um arquivo de .tbxinfo que referencia as ferramentas.
Abra um projeto de extensão Visual Studio existente.

- ou -

Defina um novo projeto de extensão Visual Studio.
1. No menu File, aponte para New, e em seguida, clique em Project.
2. No Novo projeto caixa de diálogo, em Installed Templates, expanda Visual C#, clique em extensibilidadee, em seguida, clique em o projeto VSIX. Defina o nome do projeto e clique em OK.
Adicione suas definições de toolbox para o projeto. Incluir o .tbxinfo arquivo, os arquivos do diagrama, arquivos e quaisquer arquivos de recurso de bitmap e certifique-se de que eles estão incluídos no VSIX.
- No Solution Explorer, clique com o botão direito no projeto, aponte para Adde em seguida, clique em Item existente. Na caixa de diálogo, defina objetos do tipo: Todos os arquivos. Localize os arquivos, selecione todos e, em seguida, clique em Add.
  
  Observação
  
  Neste projeto, é possível abrir os arquivos do diagrama no editor de modelo.
Defina as seguintes propriedades de todos os arquivos que você acabou de adicionar. Você pode definir suas propriedades ao mesmo tempo selecionando-os todos no Solution Explorer. Tenha cuidado para não alterar as propriedades dos arquivos no projeto.

Copy to Output Directory = Copy Always

Ação de compilação = conteúdo

Incluir no VSIX = true
Abra source.extension.vsixmanifest. Ele é aberto no editor de manifesto de extensão.
Em conteúdo, adicione uma linha que descreve as ferramentas personalizadas. Clique em Adicionar conteúdoe defina os campos na caixa de diálogo da seguinte maneira:
- Tipo de conteúdo = tipo de extensão personalizada
- Tipo =Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems
- Caminho = arquivo no projeto. Selecione seu .tbxinfo de arquivo, por exemplo MyTools.tbxinfo
Você pode definir Nome do produto e a outros campos, como você deseja.
Crie o projeto.
No Windows Explorer, abra a pasta .\bin\Debug ou .\bin\Release para encontrar o .vsix arquivo. Este é um Visual Studio arquivo de extensão. Pode ser instalado em seu computador e também são enviada para outros usuários do Visual Studio.

Observação
Neste projeto, é possível abrir os arquivos do diagrama no editor de modelo.

Para instalar ferramentas personalizadas a partir de uma extensão de Visual Studio

Clique duas vezes o .vsix no Windows Explorer, o arquivo ou abri-lo dentro de Visual Studio.
Clique em instalar na caixa de diálogo que aparece.
Para desinstalar ou desativar temporariamente a extensão, abra Extension Manager partir do Ferramentas menu.

Localização

Você pode tornar uma extensão que, quando ele é instalado em outro computador, exibirá os nomes de ferramenta e dicas de ferramentas no idioma do computador de destino.

Para fornecer versões da ferramenta em mais de um idioma

Crie um projeto de extensão de Visual Studio que contém um ou mais ferramentas personalizadas.

No .tbxinfo o arquivo, use o método de arquivo de recurso para definir a ferramenta displayName, a caixa de ferramentas tabNamee a dica de ferramenta. Criar um arquivo de recurso no qual essas cadeias de caracteres são definidas, compilá-lo em um assembly e consultá-lo do arquivo tbxinfo.
Crie assemblies adicionais que contêm arquivos de recurso com seqüências de caracteres em outros idiomas.
Coloque cada assembly adicional em uma pasta cujo nome é o código de cultura para o idioma. Por exemplo, colocar uma versão em francês do assembly dentro de uma pasta chamada fr.
Você deve usar um código de cultura neutra, normalmente duas letras, não uma cultura específica, como fr-CA. Para obter mais informações sobre códigos de cultura, consulte o método de CultureInfo. GetCultures, que fornece uma lista completa dos códigos de cultura.
Criar a extensão Visual Studio e distribuí-lo.
Quando a extensão é instalada em outro computador, a versão do arquivo de recurso para a cultura local do usuário será carregada automaticamente. Se você não tiver fornecido uma versão de cultura do usuário, os recursos padrão serão usados.

É possível usar esse método para instalar versões diferentes do diagrama de protótipo. Os nomes de elementos e os conectores serão iguais em cada instalação.

Outras operações de caixa de ferramentas

Normalmente, em Visual Studio, você pode personalizar a caixa de ferramentas, ferramentas de renomeação, movendo-os às guias da caixa de ferramentas diferentes e excluí-los. Mas essas alterações não persistem para ferramentas de modelagem personalizado criadas com os procedimentos descritos neste tópico. Quando você reiniciar o Visual Studio, ferramentas personalizadas reaparecerá com seus nomes definidos e locais da caixa de ferramentas.

Além disso, suas ferramentas personalizadas desaparecerão se você executar o Redefinir caixa de ferramentas comando. No entanto, eles reaparecerá quando você reiniciar o Visual Studio.