Ajouter un menu dans la barre de menus de Visual StudioAdd 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 des 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.

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

En 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 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 par la suite.You can also install the VS SDK later on. Pour plus d’informations, consultez installer le SDK Visual Studio.For more information, see Install the Visual Studio SDK.

Créez un projet VSIX qui dispose d’un modèle d’élément de commande personnaliséeCreate 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 créer une extension avec une commande de menu.For more information, see Create an extension with a menu command.

  2. Quand le projet s’ouvre, ajoutez un modèle d’élément de commande personnalisée nommé commande de test.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 en 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éer un menu dans la barre de menus IDECreate a menu on the IDE menu bar

  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 dans 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 sur la section de la barre de menus de Visual Studio qui contient les menus d’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 indique 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 le <groupe > et modifier le <Parent > élément pour pointer 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 la Buttons section.Find the Buttons section. Notez que le Visual StudioVisual Studio modèle de Package a généré un Button élément qui a son parent la valeur 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 appears on your menu.

Générer et tester l’extensionBuild and test 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 « Commande de test 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