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

Artigo
03/12/2013

Para facilitar a criar um elemento ou um grupo de elementos de acordo com um padrão que você frequentemente uso, você pode adicionar novas ferramentas para a caixa de ferramentas de modelagem diagramas em Visual Studio Ultimate.Você pode distribuir esses itens da caixa de ferramentas para outros usuários de Visual Studio Ultimate .

Uma ferramenta personalizada cria um ou vários novos elementos em um diagrama.Você não pode criar ferramentas personalizadas de conexão.

Por exemplo, você poderia fazer uma ferramenta personalizada para criar elementos como esses:

Um conjunto associado ao perfil do .NET, e uma classe com o estereótipo .NET.
Um par de classes vinculadas por uma associação para representar o padrão do observador.

Você pode usar esse método para criar ferramentas do elemento.Isto é, você pode criar ferramentas que você arrasta da caixa de ferramentas para um diagrama.Você não pode criar ferramentas de conexão.

Definindo uma ferramenta modelando personalizado

Para definir uma ferramenta modelando personalizado

Crie um diagrama de UML que contém um elemento ou um grupo de elementos.
- Esses elementos podem ter relacionamentos entre elas, e podem ter elementos subsidiários como portas, atributos, ou operações pinos.
Salve o diagrama usando o nome que você deseja dar à nova ferramenta.No menu de Arquivo , use Save As….
Usando Windows Explorer, copiar os dois arquivos do diagrama a seguir pasta ou a qualquer subpasta:

YourDocuments**\Visual Studio 2012\Architecture Tools\Custom Toolbox Items**
- Crie essa pasta se ainda não existir.Você pode ter que criar Architecture Tools e Custom Toolbox Items.
- Ambos copiar os arquivos de diagrama, um com um nome que terminadiagram“…” e o outro com um nome que termine “…”diagram.layout
- Você pode fazer tantas ferramentas personalizado como desejar.Use um diagrama para cada ferramenta.
(Opcional) crie um arquivo de .tbxinfo como descrito em Como definir as propriedades de ferramentas personalizadas, e adicioná-lo para o mesmo diretório.Isso permite que você defina um ícone caixa de ferramentas, dica de ferramenta, e assim por diante.
- Um único arquivo de .tbxinfo pode ser usado para definir várias ferramentas.Pode consultar os arquivos do diagrama que estão em subpastas.
Reinicie o Visual Studio.A ferramenta adicional aparecerá na caixa de ferramentas para o tipo apropriado de diagrama.

O qual ferramenta personalizada replicará

Uma ferramenta personalizada replicará a maioria dos recursos de 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.
Cores, tamanhos e formas
Estereótipos e perfis de pacote
Os valores de propriedade como são abstratas
Itens de trabalho vinculados
Multiplicities e outras propriedades relações
As posições de formas relacionados.

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

Formas simples.Essas são as formas que não são relacionados aos elementos de modelo, que você pode desenhar em alguns tipos de diagramas.
Roteamento de conexão.Se você requer conectores manualmente, o roteamento não será preservada quando a ferramenta é usada.As posições de algumas formas aninhadas, como portas, não são mantidas em relação aos proprietários.

Como definir as propriedades de ferramentas personalizadas

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

O formulário arquivo geral é a 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 qualquer pessoa:

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

- ou -

<resource fileName="Resources.dll"

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

Nesse caso, você fornece um conjunto compilado em que os valores da cadeia de caracteres foram criados como recursos.

Adicione um nó de <customToolboxItem> para cada item da caixa de ferramentas você deseja definir.

Os nós do arquivo de .tbxinfo são.Há um valor padrão para cada nó.

Nome do nó	Define
displayName	O nome do item da caixa de ferramentas.
tabName	O guia da caixa de ferramentas para que o item deve aparecer.Você pode especificar o nome da guia normal para esse tipo de diagrama, ou um nome separado.
imagem	O local do arquivo de bitmap (.bmp), que deve ter a altura e largura de 16, e uma intensidade de cor de 24 bits.
f1Keyword	A palavra-chave que encontra um tópico da ajuda.
dica de ferramenta	Uma dica de ferramenta para essa ferramenta.

Você pode editar o arquivo de bitmap em Visual Studio, e defina sua altura e largura como 16 na janela properties.

Observação
Se você começar a usar um arquivo de .tbxinfo após a experimentação com o uso do diagrama arquivos em seus próprios, você pode achar que a caixa de ferramentas contém as versões antigo e novo de um item da caixa de ferramentas.Isso também pode ocorrer se o nome do arquivo de diagrama digitada incorretamente no arquivo de .tbxinfo.Se isso ocorre, no menu de atalho da caixa de ferramentas escolha Redefinir Caixa de Ferramentas.Os itens personalizados da caixa de ferramentas desaparecerão.Reinicie o Visual Studio, e os itens personalizados corretos aparecerá.

Se você começar a usar um arquivo de .tbxinfo após a experimentação com o uso do diagrama arquivos em seus próprios, você pode achar que a caixa de ferramentas contém as versões antigo e novo de um item da caixa de ferramentas.Isso também pode ocorrer se o nome do arquivo de diagrama digitada incorretamente no arquivo de .tbxinfo.Se isso ocorre, no menu de atalho da caixa de ferramentas escolha Redefinir Caixa de Ferramentas.Os itens personalizados da caixa de ferramentas desaparecerão.Reinicie o Visual Studio, e os itens personalizados corretos aparecerá.

Como distribuir itens da caixa de ferramentas para uma extensão do Visual Studio

Você pode distribuir itens da caixa de ferramentas para outros usuários de Visual Studio empacotando os em uma extensão do Visual Studio (VSIX).Você pode compactar comandos, perfis, e outras extensões no mesmo VSIX arquivo. Para obter mais informações, Implantação de extensões do Visual Studioconsulte.

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

Para adicionar um item da caixa de ferramentas para uma extensão do Visual Studio

Criar e testar uma ou mais ferramentas personalizadas.
Crie um arquivo de .tbxinfo que referencia ferramentas.
Abrir um projeto existente de extensão do Visual Studio.

- ou -

Defina um novo projeto de extensão do Visual Studio.
1. No menu de Arquivo , escolha Novo, Projeto.
2. Na caixa de diálogo Novo Projeto , em Modelos Instalados, escolha Visual c#, Extensibilidade, Projeto de VSIX.
Adicionar suas definições de caixa de ferramentas para o projeto.Inclua o arquivo de .tbxinfo , os arquivos de diagrama, arquivos de bitmap, e todos os arquivos de recurso, e certifique-se de que estão incluídos no VSIX.
- No solution Explorer, no menu de atalho do projeto de VSIX, escolha Adicionar, Item Existente.Na caixa de diálogo, defina Objects of Type: Todos os Arquivos.Localize os arquivos, selecione-os todos, e então escolha Adicionar.
  
  Observação
  
  No projeto, você não pode abrir arquivos do diagrama no editor modelo.
Defina as seguintes propriedades de todos os arquivos que você adicionou.Você pode definir suas propriedades ao mesmo tempo selecionando quaisquer no solution Explorer.Tome cuidado para não alterar as propriedades dos outros arquivos no projeto.

Copiar para Diretório de Saída = Copiar sempre

Ação de Compilação = Conteúdo

Inclua em VSIX = true
Abra source.extension.vsixmanifest.Abre no editor de manifesto de extensão.
Em Metadados, adicione uma descrição para ferramentas personalizadas.

Em Ativos, escolha Novo e defina os campos na caixa de diálogo seguinte maneira:
- Type = Tipo personalizado de extensão
- Tipo Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems=
  
  Observação
  
  Isso não é uma das opções na lista suspensa.Você precisa fazer logon em usando o teclado.
- Origem = Arquivo no sistema de arquivos.
- Caminho = o arquivo de .tbxinfo , por exemplo MyTools.tbxinfo
Crie o projeto.
Para verificar que o trabalho de extensão, pressione F5.A instância de avaliação de começa do Visual Studio.

Na instância de avaliação, crie ou abra um diagrama de UML do tipo relevante.Verifique se a nova ferramenta aparece na caixa de ferramentas e que cria elementos corretamente.
Para obter um arquivo de VSIX para implantação: no Windows Explorer, abra a pasta .\bin\Debug ou .\bin\Release para localizar o arquivo de .vsix .Este é um arquivo de extensão de Visual Studio .Pode ser instalado no seu computador, e também ser enviado para outros usuários do Visual Studio.

Observação
No projeto, você não pode abrir arquivos do diagrama no editor modelo.

Observação
Isso não é uma das opções na lista suspensa.Você precisa fazer logon em usando o teclado.

Para instalar ferramentas personalizadas de uma extensão do Visual Studio

Abra o arquivo de .vsix no Windows Explorer no Visual Studio.
Escolha Instalar na caixa de diálogo que aparece.
Para desinstalar ou desativar temporariamente a extensão, abra Gerenciador de Extensões de Ferramentas .

Localização

Você pode fazer uma extensão que, quando é instalada em outro computador, exibe nomes e dicas de ferramenta no idioma do computador de destino.

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

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

No arquivo de .tbxinfo , use o método do arquivo de recurso para definir displayNamede ferramenta, a caixa de ferramentas tabName, e o tooltip.Crie um arquivo de recurso em que essas cadeias de caracteres são definidas, compilá-lo em um assembly, e referem-lhe do arquivo de tbxinfo.
Crie conjuntos adicionais que contêm arquivos de recurso com cadeias de caracteres em outros idiomas.
Coloque cada conjunto adicional em uma pasta cujo nome é o código de cultura para a linguagem.Por exemplo, colocando uma versão francesa do assembly em uma pasta que é 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 Método de CultureInfo.GetCultures, que fornece uma lista completa de código de cultura.
Compile a extensão do Visual Studio, e distribua-a.
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 forneceu uma versão para a cultura do usuário, recursos padrão será usado.

Você não pode usar esse método para instalar versões diferentes do diagrama de protótipo.Nomes de elementos e os conectores serão os mesmos em cada instalação.

Outras operações de caixa de ferramentas

Normalmente, em Visual Studio, você pode personalizar a caixa de ferramentas renomeando ferramentas, movendo as guias a diferentes da caixa de ferramentas, e exclusão dos. Mas essas alterações não persistem para o personalizado que modela ferramentas criadas com os procedimentos descritos neste tópico.Quando você reiniciar Visual Studio, ferramentas personalizadas reaparecerão com seus nomes e locais definidos na caixa de ferramentas.

Além disso, as ferramentas personalizadas desaparecerão se você executar o comando de Redefinir Caixa de Ferramentas .No entanto, reaparecerão quando você reiniciar Visual Studio.