Ajout d’un Menu à la barre de menus de Visual StudioAdding a Menu to the Visual Studio Menu Bar

Cette procédure pas à pas montre comment ajouter un menu dans la barre de menus de l’environnement de développement intégré (IDE) Visual Studio.This walkthrough shows how to add a menu to the menu bar of the Visual Studio integrated development environment (IDE). La barre de menus IDE contient les catégories de menu comme fichier, modifier, vue, fenêtre, et aide .The IDE menu bar contains menu categories such as File, Edit, View, Window, and Help.

Avant d’ajouter un nouveau menu à la barre de menus de Visual Studio, considérez si vos commandes doivent être placés dans un menu existant.Before adding a new menu to the Visual Studio menu bar, consider whether your commands should be placed within an existing menu. Pour plus d’informations sur le placement de commande, consultez Menus et commandes de Visual Studio.For more information about command placement, see Menus and Commands for Visual Studio.

Les menus sont déclarés dans le fichier .vsct du projet.Menus are declared in the .vsct file of the project. Pour plus d’informations sur les menus et les fichiers .vsct, consultez commandes, Menus et barres d’outils.For more information about menus and .vsct files, see Commands, Menus, and Toolbars.

À la fin de cette procédure pas à pas, vous pouvez créer un menu nommé TestMenu qui contient une seule commande.By completing this walkthrough, you can create a menu named TestMenu that contains one command.

PrérequisPrerequisites

À partir de Visual Studio 2015, vous n’installez pas le Kit de développement logiciel Visual Studio à partir du centre de téléchargement.Starting in Visual Studio 2015, you do not install the Visual Studio SDK from the download center. Il est inclus comme une fonctionnalité facultative dans le programme d’installation de Visual Studio.It is included as an optional feature in Visual Studio setup. Vous pouvez également installer le kit SDK VS ultérieurement.You can also install the VS SDK later on. Pour plus d’informations, consultez l’installation de Visual Studio SDK.For more information, see Installing the Visual Studio SDK.

Création d’un projet VSIX qui a un modèle d’élément de commande personnaliséeCreating a VSIX Project that has a Custom Command item template

  1. Créez un projet VSIX nommé TopLevelMenu.Create a VSIX project named TopLevelMenu. Vous pouvez trouver le modèle de projet VSIX dans le nouveau projet boîte de dialogue sous Visual C# / extensibilité.You can find the VSIX project template in the New Project dialog under Visual C# / Extensibility. Pour plus d’informations, consultez avec une commande de Menu pour créer une Extension.For more information, see Creating an Extension with a Menu Command.

  2. Lorsque le projet s’ouvre, ajouter un modèle d’élément de commande personnalisée nommé TestCommand.When the project opens, add a custom command item template named TestCommand. Dans le l’Explorateur de solutions, cliquez sur le nœud du projet et sélectionnez Ajouter / nouvel élément.In the Solution Explorer, right-click the project node and select Add / New Item. Dans le ajouter un nouvel élément boîte de dialogue, accédez à Visual c# / extensibilité et sélectionnez commande personnalisée.In the Add New Item dialog, go to Visual C# / Extensibility and select Custom Command. Dans le nom au bas de la fenêtre, modifiez le nom de fichier de commande pour TestCommand.cs.In the Name field at the bottom of the window, change the command file name to TestCommand.cs.

Création d’un Menu dans la barre de menus IDECreating a Menu on the IDE Menu Bar

Pour créer un menuTo create a menu

  1. Dans l’Explorateur de solutions, ouvrez TestCommandPackage.vsct.In Solution Explorer, open TestCommandPackage.vsct.

    À la fin du fichier, il existe un <symboles > nœud qui contient plusieurs <GuidSymbol > nœuds.At the end of the file, there is a <Symbols> node that contains several <GuidSymbol> nodes. Dans le nœud nommé guidTestCommandPackageCmdSet, ajoutez un nouveau symbole, comme suit :In the node named guidTestCommandPackageCmdSet, add a new symbol, as follows:

    <IDSymbol name="TopLevelMenu" value="0x1021"/>  
    
  2. Créer un vide <Menus > nœud dans le <commandes > nœud, juste avant <groupes >.Create an empty <Menus> node in the <Commands> node, just before <Groups>. Dans le <Menus > nœud, ajoutez un <Menu > nœud, comme suit :In the <Menus> node, add a <Menu> node , as follows:

    <Menus>  
          <Menu guid="guidTestCommandPackageCmdSet" id="TopLevelMenu" priority="0x700" type="Menu">  
            <Parent guid="guidSHLMainMenu"  
                    id="IDG_VS_MM_TOOLSADDINS" />  
            <Strings>  
              <ButtonText>TestMenu</ButtonText>  
              <CommandName>TestMenu</CommandName>  
            </Strings>  
        </Menu>  
    </Menus>  
    

    Le guid et id valeurs du menu spécifient le jeu de commandes et utilisez le menu spécifique dans le jeu de commandes.The guid and id values of the menu specify the command set and the specific menu in the command set.

    Le guid et id valeurs du parent positionnement le menu dans la section de la barre de menus de Visual Studio qui contient des menus Outils et compléments.The guid and id values of the parent position the menu on the section of the Visual Studio menu bar that contains the Tools and Add-ins menus.

    La valeur de la CommandName chaîne spécifie que le texte doit apparaître dans l’élément de menu.The value of the CommandName string specifies that the text should appear in the menu item.

  3. Dans le <groupes > section, recherchez la <groupe > et modifier le <Parent > élément pointe vers le menu que nous venons d’ajouter :In the <Groups> section, find the <Group> and change the <Parent> element to point to the menu we just added:

    <Groups>  
          <Group guid="guidTestCommandPackageCmdSet" id="MyMenuGroup" priority="0x0600">  
            <Parent guid="guidTestCommandPackageCmdSet" id="TopLevelMenu"/>  
          </Group>  
        </Groups>  
    

    Cela rend la partie du groupe du nouveau menu.This makes the group part of the new menu.

  4. Rechercher les Buttons section.Find the Buttons section. Notez que la Visual StudioVisual Studio modèle de Package a généré un Button élément qui a son parent définie sur MyMenuGroup.Notice that the Visual StudioVisual Studio Package template has generated a Button element that has its parent set to MyMenuGroup. Par conséquent, cette commande s’affiche dans votre menu.As a result, this command will appear on your menu.

Génération et test de l’ExtensionBuilding and Testing the Extension

  1. Générez le projet et commencez le débogage.Build the project and start debugging. Une instance de l’instance expérimentale doit apparaître.An instance of the experimental instance should appear.

  2. La barre de menus dans l’instance expérimentale doit contenir un TestMenu menu.The menu bar in the experimental instance should contain a TestMenu menu.

  3. Sur le TestMenu menu, cliquez sur appeler une commande de Test.On the TestMenu menu, click Invoke Test Command.

    Une boîte de message doit apparaître et afficher le message « TestCommand Package à l’intérieur de TopLevelMenu.TestCommand.MenuItemCallback() ».A message box should appear and display the message "TestCommand Package Inside TopLevelMenu.TestCommand.MenuItemCallback()". Cela indique que la nouvelle commande fonctionne.This indicates that the new command works.

Voir aussiSee Also

Commandes, menus et barres d’outilsCommands, Menus, and Toolbars