Ajouter une barre d’outilsAdd a Toolbar

Cette procédure pas à pas montre comment ajouter une barre d’outils à l’IDE Visual Studio.This walkthrough shows how to add a toolbar to the Visual Studio IDE.

Une barre d’outils est une bande horizontale ou verticale qui contient les boutons qui sont liés aux commandes.A toolbar is a horizontal or vertical strip that contains buttons that are bound to commands. En fonction de son implémentation, une barre d’outils dans l’IDE peut être repositionné, ancré sur n’importe quel côté de la fenêtre principale de l’IDE ou apportée à rester devant les autres fenêtres.Depending on its implementation, a toolbar in the IDE can be repositioned, docked on any side of the main IDE window, or made to stay in front of other windows.

En outre, les utilisateurs peuvent ajouter des commandes à une barre d’outils ou les supprimer à partir de celui-ci à l’aide de la personnaliser boîte de dialogue.In addition, users can add commands to a toolbar or remove them from it by using the Customize dialog box. En règle générale, les barres d’outils dans les VSPackages sont personnalisables par l’utilisateur.Typically, toolbars in VSPackages are user-customizable. L’IDE gère toutes les personnalisations, et le VSPackage répond aux commandes.The IDE handles all customization, and the VSPackage responds to commands. Le VSPackage n’a pas de savoir où se trouve physiquement une commande.The VSPackage does not have to know where a command is physically located.

Pour plus d’informations sur les menus, consultez commandes, menus et barres d’outils.For more information about menus, see Commands, menus, and toolbars.

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éer une extension avec une barre d’outilsCreate an extension with a toolbar

Créez un projet VSIX nommé IDEToolbar.Create a VSIX project named IDEToolbar. Ajouter un modèle d’élément commande menu nommé ToolbarTestCommand.Add a menu command item template named ToolbarTestCommand. Pour savoir comment procéder, consultez créer une extension avec une commande de menu.For information about how to do this, see Create an extension with a menu command.

Créer une barre d’outils pour l’IDECreate a toolbar for the IDE

  1. Dans ToolbarTestCommandPackage.vsct, recherchez la section de symboles.In ToolbarTestCommandPackage.vsct, look for the Symbols section. Dans l’élément GuidSymbol nommé guidToolbarTestCommandPackageCmdSet, ajoutez les déclarations pour une barre d’outils et un groupe de la barre d’outils, comme suit.In the GuidSymbol element named guidToolbarTestCommandPackageCmdSet, add declarations for a toolbar and a toolbar group, as follows.

    <IDSymbol name="Toolbar" value="0x1000" />
    <IDSymbol name="ToolbarGroup" value="0x1050" />
    
    
  2. En haut de la section Commands, créez une section de Menus.At the top of the Commands section, create a Menus section. Ajoutez un élément de Menu à la section de Menus pour définir votre barre d’outils.Add a Menu element to the Menus section to define your toolbar.

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

    Barres d’outils ne peuvent pas être imbriquées telles que des sous-menus.Toolbars cannot be nested like submenus. Par conséquent, vous n’avez pas lui affecter un groupe parent.Therefore, you do not have to assign a parent group. En outre, il est inutile de définir une priorité, car l’utilisateur peut déplacer des barres d’outils.Also, you do not have to set a priority, because the user can move toolbars. En règle générale, un placement initial d’une barre d’outils est défini par programmation, mais les modifications ultérieures apportées par l’utilisateur sont conservées.Typically, initial placement of a toolbar is defined programmatically, but subsequent changes by the user are persisted.

  3. Dans le groupes section, après l’entrée de groupe existant, définir un groupe élément destiné à contenir les commandes de la barre d’outils.In the Groups section, after the existing group entry, define a Group element to contain the commands for the toolbar.

    <Group guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup"
          priority="0x0000">
      <Parent guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar"/>
    </Group>
    
  4. Afficher le bouton sur la barre d’outils.Make the button appear on the toolbar. Dans la section boutons, remplacez le bloc Parent dans le bouton de la barre d’outils.In the Buttons section, replace the Parent block in the Button to the toolbar. Le bloc de bouton résultant doit ressembler à ceci :The resulting Button block should look like this:

    <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>
    

    Par défaut, si une barre d’outils n’a aucune commande, il n’apparaît pas.By default, if a toolbar has no commands, it does not appear.

  5. Générez le projet et commencez le débogage.Build the project and start debugging. L’instance expérimentale doit apparaître.The experimental instance should appear.

  6. Avec le bouton droit de la barre de menus de Visual Studio pour obtenir la liste des barres d’outils.Right-click the Visual Studio menu bar to get the list of toolbars. Sélectionnez barre d’outils de Test.Select Test Toolbar.

  7. Vous devez maintenant voir votre barre d’outils sous forme d’icône à droite de l’icône de recherche dans les fichiers.You should now see your toolbar as an icon to the right of the Find in Files icon. Lorsque vous cliquez sur l’icône, vous devez voir une boîte de message indiquant que ToolbarTestCommandPackage. Inside IDEToolbar.ToolbarTestCommand.MenuItemCallback() .When you click the icon, you should see a message box that says ToolbarTestCommandPackage. Inside IDEToolbar.ToolbarTestCommand.MenuItemCallback().

Voir aussiSee also