Ajouter une barre d’outils

  • Article

Cette procédure pas à pas montre comment ajouter une barre d’outils à l’IDE Visual Studio.

Une barre d’outils est une bande horizontale ou verticale qui contient des boutons liés aux commandes. En fonction de son implémentation, une barre d’outils de l’IDE peut être repositionnée, ancrée sur n’importe quel côté de la fenêtre IDE principale ou effectuée pour rester devant d’autres fenêtres.

En outre, les utilisateurs peuvent ajouter des commandes à une barre d’outils ou les supprimer à l’aide de la boîte de dialogue Personnaliser . En règle générale, les barres d’outils dans VSPackages sont personnalisables par l’utilisateur. L’IDE gère toutes les personnalisations, et VSPackage répond aux commandes. VsPackage n’a pas besoin de savoir où se trouve physiquement une commande.

Pour plus d’informations sur les menus, consultez Commandes, menus et barres d’outils.

Créer une extension avec une barre d’outils

Créez un projet VSIX nommé IDEToolbar. Ajoutez un modèle d’élément de commande de menu nommé ToolbarTestCommand. Pour plus d’informations sur la procédure à suivre, consultez Créer une extension avec une commande de menu.

Créer une barre d’outils pour l’IDE

  1. Dans ToolbarTestCommandPackage.vsct, recherchez la section Symboles. Dans l’élément GuidSymbol nommé guidToolbarTestCommandPackageCmdSet, ajoutez des déclarations pour une barre d’outils et un groupe de barres d’outils, comme suit.

    <IDSymbol name="Toolbar" value="0x1000" />
<IDSymbol name="ToolbarGroup" value="0x1050" />

  2. En haut de la section Commandes, créez une section Menus. Ajoutez un élément Menu à la section Menus pour définir votre barre d’outils.

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

    Les barres d’outils ne peuvent pas être imbriquées comme les sous-menus. Par conséquent, vous n’avez pas besoin d’affecter un groupe parent. En outre, vous n’avez pas besoin de définir une priorité, car l’utilisateur peut déplacer des barres d’outils. En règle générale, le placement initial d’une barre d’outils est défini par programme, mais les modifications suivantes par l’utilisateur sont conservées.

  3. Dans la section Groups , après l’entrée de groupe existante, définissez un élément Group pour contenir les commandes de la barre d’outils.

    <Group guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup" priority="0x0000">
    <Parent guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar" />
</Group>

  4. Faites apparaître le bouton dans la barre d’outils. Dans la section Boutons, remplacez le bloc Parent dans le bouton par la barre d’outils. Le bloc Bouton résultant doit ressembler à ceci :

    <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 pas de commandes, elle n’apparaît pas.

  5. Générez le projet et commencez le débogage. L’instance expérimentale doit apparaître.

  6. Cliquez avec le bouton droit sur la barre de menus de Visual Studio pour obtenir la liste des barres d’outils. Sélectionnez La barre d’outils test.

  7. Vous devez maintenant voir votre barre d’outils sous forme d’icône à droite de l’icône Rechercher dans les fichiers. Lorsque vous cliquez sur l’icône, vous devez voir une boîte de message indiquant ToolbarTestCommandPackage. Dans IDEToolbar.ToolbarTestCommand.MenuItemCallback().

Contenu connexe