Passo a passo: Adicionando um Menu à barra de menus de Visual Studio (C#)

Artigo
05/18/2015

Esta explicação passo a passo mostra como adicionar um menu à barra de menus da Visual Studio o ambiente de desenvolvimento integrado (IDE). A barra de menus do IDE contém categorias de menu, como arquivo, Editar, Exibir, janela, e Help.

Ao concluir este passo a passo, você pode criar um menu chamado TestMenu que contém um único comando. Se o comando não estiver disponível, o menu não aparecerá.

Menus são declarados no arquivo .vsct do projeto. Para obter mais informações sobre a menus e os arquivos de .vsct, 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 criar o TopLevelMenu VSPackage

Criar um VSPackage chamado TopLevelMenu. Para obter mais informações, consulte Passo a passo: Criando um comando de Menu usando o modelo de pacote de Visual Studio.
No Visual Studio pacote de modelo, definir a linguagem de programação Visual C# ou Visual Basic, selecione Comando de Menu, defina o nome do comando como Comando Teste defina a ID de comando para cmdidTestCommand.

Em Solution Explorer, abra TopLevelMenu.vsct.

No final do arquivo, há um Symbols o nó que contém várias GuidSymbol nós. No nó chamado "guidTopLevelMenuCmdSet", adicione um novo símbolo, da seguinte forma:
```
<IDSymbol name="TopLevelMenu" value="0x1021"/>
```
Criar um vazio Menus nó a Commands nó, antes Groups.
No Menus nó, crie o seguinte Menu o nó para definir o menu registrado na etapa 2:
```
<Menu guid="guidTopLevelMenuCmdSet"
id="TopLevelMenu" priority="0x700" type="Menu">
  <Parent guid="guidSHLMainMenu"
          id="IDG_VS_MM_TOOLSADDINS" />
  <Strings>
    <ButtonText>TestMenu</ButtonText>
    <CommandName>TestMenu</CommandName>
  </Strings>
</Menu>
```
O guid e id valores do menu especificam o conjunto de comandos e use o menu específico no conjunto de comando.

O guid e id valores do pai posicionar o menu na seção da barra de menus de Visual Studio que contém os menus do Add-ins e ferramentas.

O valor da CommandName seqüência de caracteres que especifica que o texto aparecerá no item de menu.
Alterar o par GUID/ID do pai gerado Group nó para que ela seja a mesma do menu que você criou, da seguinte maneira:
```
 <Group guid="guidTopLevelMenuCmdSet" id="MyMenuGroup"
priority="0x0600">
   <Parent guid="guidTopLevelMenuCmdSet" id="TopLevelMenu"/>
 </Group>
```
Isso faz parte do grupo do novo menu.
Encontrar o Buttons seção. Observe que o Visual Studio o modelo de pacote tem gerado uma Button elemento que tenha seu pai definido como MyMenuGroup. Como resultado, esse comando aparecerá em seu menu.

Criar e testar o pacote de TopLevelMenu

Para criar e testar o VSPackage

Pressione F5 para abrir uma instância da Visual Studio ambiente experimental no modo de depuração.
A barra de menus na Visual Studio ambiente experimental deve conter um TestMenu menu está posicionado antes do Analyze menu.
Sobre o TestMenu menu, clique em Comando Test.

Uma caixa de mensagem deve aparecer e exibir a mensagem "Dentro do Company.TopLevelMenu.TopLevelMenuPackage.MenuItemCallback()". Isso indica que o novo comando funciona.

Consulte também

Outros recursos

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

Comandos, Menus e barras de ferramentas

Partilhar via