Passo a passo: Adicionando uma barra de ferramentas para uma janela de ferramenta

Artigo
05/18/2015

Esta explicação passo a passo mostra como adicionar uma barra de ferramentas para uma janela de ferramenta. Barras de ferramentas fornecem acesso rápido aos comandos na janela da ferramenta.

Uma barra de ferramentas é uma faixa horizontal ou vertical que contém botões vinculado aos comandos. O comprimento de uma barra de ferramentas em uma janela de ferramenta é sempre o mesmo que a largura ou altura da janela de ferramenta, dependendo de onde a barra de ferramentas está ancorada.

Barras de ferramentas em janelas de ferramentas não são criadas automaticamente pelo ambiente de desenvolvimento integrado (IDE). Eles devem ser adicionados por meio de programação, o que cria a janela da ferramenta VSPackage.

Ao contrário das barras de ferramentas no IDE, uma barra de ferramentas em uma janela de ferramenta deve ser encaixada e não pode ser movida ou personalizada. Se o VSPackage da janela da ferramenta é escrito em código gerenciado, a barra de ferramentas está sempre encaixada na borda superior da janela. No entanto, se o VSPackage é escrito em código de umanaged, a barra de ferramentas pode ser encaixada em qualquer canto.

Para obter mais informações sobre como adicionar uma barra de ferramentas ao IDE, consulte Passo a passo: Adicionando uma barra de ferramentas ao IDE.

Pré-requisitos

Para concluir este passo a passo, você deve instalar o SDL do Visual Studio 2010.

Dica

Para obter mais informações sobre o SDK de Visual Studio, consulte Ampliando a visão geral de Visual Studio.Para descobrir como fazer o download do SDK do Visual Studio, consulte Visual Studio extensibilidade Developer Center no site do MSDN.

Locais para o modelo de projeto de pacote de Visual Studio

O modelo de projeto do pacote de Visual Studio está disponível nos três locais, o Novo projeto caixa de diálogo:

Em Visual Basic extensibilidade. O idioma padrão do projeto é Visual Basic.
Em C# extensibilidade. O idioma padrão do projeto é C#.
Em outra extensibilidade de tipos de projeto. O idioma padrão do projeto é C++.

Criando um VSPackage para uma janela de ferramenta

Esta seção demonstra como usar o Visual Studio modelo de projeto de pacote para criar um janela de ferramenta VSPackage que suporta apenas um comando de menu.

Para criar o TWToolbar VSPackage

Criar um VSPackage chamado TWbarra de ferramentas. Para obter mais informações, consulte Passo a passo: Criando um comando de Menu usando o modelo de pacote de Visual Studio.
Definir a linguagem de programação Visual Basic ou **Visual C#**e selecione o Comando de Menu e Janela da ferramenta opções.
Em Opções de comando, defina o nome do comando para TWTest comando, e o comando ID para cmdidTWTestCmd.
Em Janela Opções da ferramenta, defina o nome da janela para Janela de ferramenta de teste, e identificação de comando cmdidTestTool.

Criando uma barra de ferramentas para uma janela de ferramenta

Para criar uma barra de ferramentas da janela de ferramenta

Abra TWToolbar.vsct no editor de texto.
No Symbols seção, o GuidSymbol nó chamado "guidTWToolbarCmdSet", declare uma barra de ferramentas e um grupo da barra de ferramentas, como a seguir.
```
<IDSymbol name="TWToolbar" value="0x1000" />
<IDSymbol name="TWToolbarGroup" value="0x1050" />
```
Na parte superior a Commands seção, criar um Menus seção.
```
<Menus></Menus>
```
A definição da barra de ferramentas está localizada aqui porque o analisador VSCT não faz distinção entre os menus e barras de ferramentas nesse nível.
Adicionar um Menu elemento para o Menus seção para definir a barra de ferramentas.
```
<Menu guid="guidTWToolbarCmdSet" id="TWToolbar" type="ToolWindowToolbar">
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
Barras de ferramentas não podem ser aninhadas como submenus. Portanto, você não precisará atribuir um pai. Além disso, você não precisará definir uma prioridade, porque o usuário pode mover as barras de ferramentas. Normalmente, o posicionamento inicial de uma barra de ferramentas é definido por meio de programação, mas as alterações subseqüentes feitas pelo usuário são persistentes.

No Groups seção, após a entrada de grupo existente, defina um grupo para conter os comandos da barra de ferramentas.

<Group guid="guidTWToolbarCmdSet" id="TWToolbarGroup" priority="0x0000">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbar" />
</Group>

No Buttons seção, alterar o pai dos existente Button grupo de elemento para a barra de ferramentas para que a barra de ferramentas será exibida.
```
<Button guid="guidTWToolbarCmdSet" id="cmdidTWTestCommand" priority="0x0100" type="Button">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbarGroup" />
  <Icon guid="guidImages" id="bmpPic1" />
  <Strings>
    <CommandName>cmdidTWTestCmd</CommandName>
    <ButtonText>TWTest Command</ButtonText>
  </Strings>
</Button>
```
Por padrão, se uma barra de ferramentas não tem nenhum comando, ele não aparecerá.

Porque a nova barra de ferramentas não é adicionada automaticamente a janela da ferramenta, o Visual Studio IDE, a barra de ferramentas deve ser adicionada programaticamente pelo VSPackage propriamente dito. Isso é discutido na próxima seção, "Adicionando uma barra de ferramentas para a janela da ferramenta".

Adicionando a barra de ferramentas para a janela de ferramenta

Para adicionar a barra de ferramentas para a janela de ferramenta

No projeto TWToolbar, abra PkgCmdID.vb ou PkgCmdID.cs no editor de texto.
Após as IDs de comando existentes no arquivo PkgCmdID, adicione a ID de comando a seguir.
```
public const int TWToolbar = 0x1000;
```
Abra o MyToolWindow.vb ou MyToolWindow.cs no editor de texto.
Na parte superior do arquivo, após o outro Imports ou using instruções, adicione a seguinte linha.
```
using System.ComponentModel.Design; // for CommandID
```
No MyToolWindow o construtor de classe, no início do construtor, adicione a seguinte linha.
```
this.ToolBar = new CommandID(
    GuidList.guidTWToolbarCmdSet,
    PkgCmdIDList.TWToolbar);
```
Esse código diz a estrutura de pacote gerenciado (MPF) ao qual barra de ferramentas para criar quando a janela da ferramenta é criada.

Dica

No código gerenciado, apenas uma barra de ferramentas pode ser adicionada a uma janela de ferramenta.
Sobre o Build menu, clique em Build Solution para criar a solução.

A barra de ferramentas de teste na janela da ferramenta

Para testar a barra de ferramentas na janela da ferramenta

Pressione F5 para abrir uma instância do experimental Visual Studio no modo de depuração.
Sobre o Exibir , aponte para Other Windows e, em seguida, clique em Janela da ferramenta de teste para exibir a janela de ferramenta.

Observe que uma barra de ferramentas é exibida logo abaixo do título da janela de ferramenta.
Na barra de ferramentas da janela de ferramenta, clique no ícone para exibir a mensagem "Dentro do Company.TWToolbar.TWToolbarPackage.MenuItemCallback()".

Consulte também

Tarefas

Passo a passo: Adicionando uma barra de ferramentas ao IDE

Outros recursos

Explicações passo a passo para comandos, Menus e barras de ferramentas

Comandos, Menus e barras de ferramentas

Compartilhar via