Compartilhar via


Passo a passo: Adicionando uma barra de ferramentas ao IDE

Esta explicação passo a passo mostra como adicionar uma barra de ferramentas para o Visual Studio o ambiente de desenvolvimento integrado (IDE).

Uma barra de ferramentas é uma faixa horizontal ou vertical que contém botões que estão vinculados aos comandos. Dependendo de sua implementação, uma barra de ferramentas no IDE pode ser reposicionada, encaixada em qualquer lado da janela principal do IDE ou feita para permanecer na frente de outras janelas.

Além disso, os usuários podem adicionar comandos a uma barra de ferramentas ou removê-los a partir dele, usando o Personalizar caixa de diálogo. Normalmente, as barras de ferramentas no VSPackages são personalizáveis pelo usuários. O IDE manipula toda a personalização e o VSPackage responde a comandos. O VSPackage não precisa saber onde está localizado fisicamente um comando.

Para obter mais informações sobre a menus, consulte Comandos, Menus e barras de ferramentas.

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 barra de ferramentas.

Esta seção demonstra como usar o modelo de projeto do pacote de Visual Studio para criar um VSPackage que ofereça suporte a uma barra de ferramentas que possui apenas um comando de menu.

Para criar a barra de ferramentas VSPackage

  1. Criar um VSPackage chamado IDEToolbar. Para obter mais informações, consulte Passo a passo: Criando um comando de Menu usando o modelo de pacote de Visual Studio.

  2. No Visual Studio pacote de modelo, definir a linguagem de programação Visual Basic ou Visual C#, selecione Comando de Menu, defina o nome do comando como barra de ferramentasComando Teste defina a ID de comando para cmdidTestCmd.

Criando uma barra de ferramentas para o IDE.

Para criar uma barra de ferramentas para o IDE.

  1. Abra IDEToolbar.vsct no editor de texto.

  2. No símbolos seção, o GuidSymbol elemento chamado "guidIDEToolbarCmdSet", adicione declarações para uma barra de ferramentas e um grupo de barra de ferramentas, da seguinte maneira.

    <IDSymbol name="Toolbar" value="0x1000" />
    <IDSymbol name="ToolbarGroup" value="0x1050" />
    
  3. Na parte superior a comandos 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.

  4. Adicionar um Menu elemento para o Menus seção para definir sua barra de ferramentas.

    <Menu guid="guidIDEToolbarCmdSet" id="Toolbar"
          type="Toolbar" >
      <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 grupo 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.

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

    <Group guid="guidIDEToolbarCmdSet" id="ToolbarGroup"
          priority="0x0000">
      <Parent guid="guidIDEToolbarCmdSet" id="Toolbar"/>
    </Group>
    
  6. No botões seção, alterar o pai dos existente botão grupo de elemento para a barra de ferramentas para que a barra de ferramentas será exibida.

    <Parent guid="guidIDEToolbarCmdSet" id="ToolbarGroup" />
    

    Por padrão, se uma barra de ferramentas não tem nenhum comando, ele não aparecerá.

  7. Sobre o Build menu, clique em Build Solution. Corrija quaisquer erros que possam ocorrer.

  8. Pressione F5 para abrir o experimental Visual Studio no modo de depuração.

  9. Clique com o botão direito na barra de menus do IDE e, em seguida, clique em Barra de ferramentas de teste na lista de barras de ferramentas.

  10. Quando você clica no ícone na barra de ferramentas nova, a mensagem "Dentro do Company.Toolbar.ToolbarPackage.MenuItemCallback()" deve ser exibida.

Consulte também

Outros recursos

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

Comandos, Menus e barras de ferramentas