Como: criar barras de ferramentas no IDE

Artigo
05/18/2015

Você pode adicionar uma barra de ferramentas para o ambiente de desenvolvimento integrado (IDE), definindo um menu do tipo Toolbar em um arquivo de .vsct VSPackage.

Uma barra de ferramentas possui as seguintes características:

Uma barra de ferramentas é uma barra horizontal ou vertical que contém botões. Os botões podem ter um ícone ou texto ou uma combinação de ícone e texto.
Uma barra de ferramentas pode ser encaixada em qualquer canto da sua janela pai.
O IDE trata de uma barra de ferramentas da contribuição VSPackage exatamente como ele trata as barras de ferramentas que estão incluídas no Visual Studio. O VSPackage não precisa fazer nada por meio de programação para permitir a sua barra de ferramentas sejam reconhecidos pelo Personalizar caixa de diálogo. Se um usuário personaliza a barra de ferramentas, o IDE controla automaticamente as alterações.
O IDE permite automaticamente que a barra de ferramentas aparecem na barras de ferramentas submenu da Exibir menu para que os usuários poderão ocultá-la ou exibi-la.
Uma barra de ferramentas que não possui um comando visível automaticamente está oculto.

Você pode alterar essas características especificando sinalizadores ao definir a barra de ferramentas no arquivo .vsct, conforme mostrado no procedimento a seguir.

Para criar uma barra de ferramentas no IDE

Crie um pacote executando o modelo de pacote Visual Studio. Siga as instruções de criação do pacote de Passo a passo: Adicionando uma barra de ferramentas ao IDE.
Abra o arquivo de .vsct no editor. Na seção que é formada pela símbolos seção, encontrar o GuidSymbol o elemento que contém seus menus, grupos e comandos.
Conforme mostrado no exemplo a seguir, adicione um IDSymbol elemento para cada um deles: uma barra de ferramentas, um grupo de comandos e um ou mais comandos.
```
<IDSymbol name="MyMenuGroup" value="0x1020" />
<IDSymbol name="cmdidTestCmd" value="0x0100" />
<IDSymbol name="Toolbar" value="0x1000" />
<IDSymbol name="ToolbarGroup" value="0x1050" />
```
O name atributos da GuidSymbol e IDSymbol elementos em uma barra de ferramentas definida, comando ou grupo fornecem o par de GUID:ID que representa a barra de ferramentas, comando ou grupo. O GUID representa um conjunto de comandos que é definido para o VSPackage. Vários conjuntos de comandos podem ser definidos no pacote. O par de GUID:ID que é usado para identificar cada item deve ser exclusivo.
Logo acima da seção que é formada pela grupos seção, criar um Menus seção.
Definir a barra de ferramentas como um Menu elemento a Menus seção, da seguinte maneira:
1. Definir o guid e id atributos para o GUID:ID da nova barra de ferramentas.
2. Definir o priority atributo (opcional).
  
  O priority atributo normalmente é omitido para uma barra de ferramentas porque ele pode ser movido por usuários. Omitindo o priority atributo tem o mesmo efeito que defini-la como 0. No entanto, se a mesma janela tiver várias barras de ferramentas, você pode atribuir suas posições de partida, definindo suas prioridades.
3. Definir o type para o atributo barra de ferramentas.
4. No Menu elemento, use o seqüências elemento para criar uma seção que contém um texto de botão elemento e uma CommandName elemento. O ButtonText elemento é usado para definir o nome da barra de ferramentas, como ele aparece no IDE. O CommandName elemento é usado para definir o nome do comando que pode ser digitado na comando janela para acessar a barra de ferramentas.
  
  Se você quiser adicionar sinalizadores de comando, adicione um CommandFlag elemento para cada um deles.
  
  Para obter descrições dos valores de sinalizador de comando, consulte Elemento de sinalizador de comando.
O exemplo a seguir define uma barra de ferramentas.
```
<Menu guid="guidIDEToolbarCmdSet" id="Toolbar"
      type="Toolbar" >
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
Dica

Você não precisará definir um pai de um menu do tipo Toolbar porque ele é automaticamente colocado no IDE.Qualquer configuração para o pai será ignorada.
Na seção que é formada pela grupos seção, criar um grupo elemento para conter os comandos que você deseja que apareça na barra de ferramentas.
1. Defina a prioridade do grupo para determinar onde ela aparecerá na barra de ferramentas.
  
  Um grupo que tenha uma configuração de prioridade baixa aparecerá no lado esquerdo da barra de ferramentas (ou superior, dependendo de como a barra de ferramentas é orientada).
2. Defina o pai do grupo para o GUID:ID da barra de ferramentas.
O grupo a seguir é exibida na barra de ferramentas.
```
<Group guid="guidIDEToolbarCmdSet" id="ToolbarGroup"
      priority="0x0000">
  <Parent guid="guidIDEToolbarCmdSet" id="Toolbar"/>
</Group>
```
Adicionar comandos à barra de ferramentas, criando entradas de comando na seção que é formada pela botões seção. Defina o pai de cada entrada de comando para o GUID:ID do seu grupo. Cada botão elemento deve ter um GUID:ID que corresponde a uma entrada na Symbols seção.

Use o priority o atributo de cada entrada de botão para especificar onde o comando será exibida no grupo.

O exemplo a seguir define um botão que aparecerá na barra de ferramentas.
```
<Button guid="guidIDEToolbarCmdSet" id="cmdidTestCmd" priority="0x0100" type="Button">
  <Parent guid="guidIDEToolbarCmdSet" id="ToolbarGroup" />
  <Icon guid="guidImages" id="bmpPic1" />
  <Strings>
    <CommandName>cmdidTestCmd</CommandName>
    <ButtonText>Toolbar Test Command</ButtonText>
  </Strings>
</Button>
```
Para obter mais informações sobre itens de menu e botões, consulte Elemento button.