tutorial: Agregar un menú a la barra de menús de Visual Studio (C#)

Artículo
05/18/2015

Este tutorial muestra cómo agregar un menú a la barra de menús del entorno de desarrollo integrado de (IDE) Visual Studio . La barra de menús del IDE contiene categorías de menú como Archivo, Editar, Ver, Ventana, y Ayuda.

En este tutorial, puede crear un menú denominado TestMenu que contiene un comando. Si el comando no está disponible, el menú no aparece.

Los menús se declaran en el archivo de .vsct del proyecto. Para obtener más información sobre los menús y archivos de .vsct, vea comandos, menús, y barras de herramientas.

Requisitos previos

Para completar este tutorial, debe instalar Visual Studio 2010 SDK.

Nota

Para obtener más información sobre el SDK de Visual Studio, vea Información general de Visual Studio que extiende.Para averiguar cómo descargar el SDK de Visual Studio, vea Centro para desarrolladores de extensibilidad de Visual Studio en el sitio web de MSDN.

Ubicaciones de la plantilla de proyecto paquete de Visual Studio

La plantilla de proyecto paquete de Visual Studio está disponible en tres ubicaciones en el cuadro de diálogo de Nuevo proyecto :

En extensibilidad de Visual Basic. El idioma predeterminado del proyecto es Visual Basic.
En extensibilidad de C#. El lenguaje predeterminado del proyecto es C#.
En La otra extensibilidad de los tipos de proyecto. El lenguaje predeterminado del proyecto es C++.

crear un VSPackage

para crear el TopLevelMenu VSPackage

Cree un Paquete denominado TopLevelMenu. Para obtener más información, vea tutorial: Crear un comando de menú mediante la plantilla de paquete de Visual Studio.
En la plantilla de paquete de Visual Studio , establezca el lenguaje de programación a Visual c# o Visual Basic, seleccione Comando de menú, establezca el nombre de comando a Comando de prueba, y el identificador de comando de conjunto a cmdidTestCommand.

Crear un menú de la barra de menús del IDE

para crear un menú

En Explorador de soluciones, abra TopLevelMenu.vsct.

Al final del archivo, hay un nodo de Symbols que contiene varios nodos de GuidSymbol . en el nodo denominado “guidTopLevelMenuCmdSet”, agregue un nuevo símbolo, como sigue:
```
<IDSymbol name="TopLevelMenu" value="0x1021"/>
```
Cree un nodo vacío de Menus en el nodo de Commands , justo antes de Groups.
En el nodo de Menus , cree el siguiente nodo de Menu para definir el menú registrado en el paso 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>
```
Los valores de guid y de id de menú especifican el comando establecido y el menú concreto en el conjunto de comandos.

Los valores de guid y de id de posición primaria el menú respecto a la sección de la barra de menús de Visual Studio que contiene las herramientas y menús de complementos.

el valor de la cadena de CommandName especifica que el texto debe aparecer en el elemento de menú.
Cambie los pares de GUID/ID del elemento primario del nodo representado de Group de modo que sea igual que el del menú que creó, como sigue:
```
 <Group guid="guidTopLevelMenuCmdSet" id="MyMenuGroup"
priority="0x0600">
   <Parent guid="guidTopLevelMenuCmdSet" id="TopLevelMenu"/>
 </Group>
```
Esto crea la parte del grupo del nuevo menú.
Busque la sección de Buttons . Observe que la plantilla de paquete de Visual Studio generó un elemento de Button que tiene su elemento primario establecido en MyMenuGroup. Como resultado, este comando aparecerá en el menú.

Compilar y probar el paquete de TopLevelMenu

Para compilar y probar el paquete VSPackage

Presione F5 para abrir una instancia de entorno experimental de Visual Studioen modo de depuración.
La barra de menús del entorno experimental de Visual Studiodebe contener un menú deTestMenuque se coloque justo antes del menú de Analizar .
En el menú de TestMenu , haga clic Comando de prueba.

Debe aparecer un cuadro de mensaje y mostrar el mensaje “dentro de Company.TopLevelMenu.TopLevelMenuPackage.MenuItemCallback()”. Esto indica que el nuevo comando.

Vea también

Otros recursos

Tutoriales para los comandos, menús, barras de herramientas y

comandos, menús, y barras de herramientas

Compartir a través de