Adicionar uma barra de ferramentas

  • Artigo

Este passo a passo mostra como adicionar uma barra de ferramentas para o IDE do Visual Studio.

Uma barra de ferramentas é uma faixa horizontal ou vertical que contém botões vinculados a 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 ficar na frente de outras janelas.

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

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

Criar uma extensão com uma barra de ferramentas

Crie um projeto VSIX chamado IDEToolbar. Adicione um modelo de item de comando de menu chamado ToolbarTestCommand. Para obter informações sobre como fazer isso, consulte Criar uma extensão com um comando de menu.

Criar uma barra de ferramentas para o IDE

  1. Em ToolbarTestCommandPackage.vsct, procure a seção Símbolos. No elemento GuidSymbol chamado guidToolbarTestCommandPackageCmdSet, adicione declarações para uma barra de ferramentas e um grupo de barras de ferramentas, da seguinte maneira.

    <IDSymbol name="Toolbar" value="0x1000" />
<IDSymbol name="ToolbarGroup" value="0x1050" />

  2. Na parte superior da seção Comandos, crie uma seção Menus. Adicione um elemento Menu à seção Menus para definir sua barra de ferramentas.

    <Menus>
    <Menu guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar" type="Toolbar">
        <CommandFlag>DefaultDocked</CommandFlag>
        <Strings>
            <ButtonText>Test Toolbar</ButtonText>
            <CommandName>Test Toolbar</CommandName>
        </Strings>
    </Menu>
</Menus>

    As barras de ferramentas não podem ser aninhadas como submenus. Portanto, não é necessário atribuir um grupo pai. Além disso, você não precisa definir uma prioridade, porque o usuário pode mover barras de ferramentas. Normalmente, o posicionamento inicial de uma barra de ferramentas é definido programaticamente, mas as alterações subsequentes pelo usuário são persistentes.

  3. Na seção Grupos, após a entrada de grupo existente, defina um elemento Group para conter os comandos da barra de ferramentas.

    <Group guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup" priority="0x0000">
    <Parent guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar" />
</Group>

  4. Faça com que o botão apareça na barra de ferramentas. Na seção Botões, substitua o bloco Pai no Botão para a barra de ferramentas. O bloco de botões resultante deve ter a seguinte aparência:

    <Button guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarTestCommandId" priority="0x0100" type="Button">
    <Parent guid= "guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup" />
    <Icon guid="guidImages" id="bmpPic1" />
    <Strings>
        <ButtonText>Invoke ToolbarTestCommand</ButtonText>
    </Strings>
</Button>

    Por padrão, se uma barra de ferramentas não tiver comandos, ela não será exibida.

  5. Compile o projeto e comece a depuração. A instância experimental deve aparecer.

  6. Clique com o botão direito do mouse na barra de menus do Visual Studio para obter a lista de barras de ferramentas. Selecione Barra de ferramentas de teste.

  7. Agora você deve ver sua barra de ferramentas como um ícone à direita do ícone Localizar em arquivos. Quando você clica no ícone, você deve ver uma caixa de mensagem que diz ToolbarTestCommandPackage. Dentro de IDEToolbar.ToolbarTestCommand.MenuItemCallback().

Conteúdo relacionado