Procédure pas - à - pas : Ajouter une barre d'outils à une fenêtre Outil

Article
05/17/2015

Cette procédure pas - à - pas montre comment ajouter une barre d'outils à une fenêtre Outil. Les barres d'outils fournissent un accès rapide aux commandes dans la fenêtre Outil.

une barre d'outils est une bande horizontale ou verticale qui contient des boutons liés aux commandes. La longueur d'une barre d'outils dans une fenêtre Outil est toujours identique à la largeur ou la hauteur de la fenêtre Outil, en fonction de la barre d'outils est ancrée.

Les barres d'outils dans des fenêtres Outil ne sont pas créées automatiquement par l'environnement de développement intégré (IDE) (IDE). ils doivent être ajoutés par programme par le VSPackage qui crée la fenêtre Outil.

Contrairement aux barres d'outils dans l'IDE, une barre d'outils dans une fenêtre Outil doit être ancrée et ne peut pas être déplacée ou personnalisée. Si la fenêtre Outil VSPackage est écrite en code managé, la barre d'outils est toujours ancrée sur le bord supérieur de la fenêtre. Toutefois, si le VSPackage est écrit en code umanaged, la barre d'outils peut être ancrée sur un bord.

Pour plus d'informations sur l'ajout d'une barre d'outils à l'IDE, consultez Procédure pas - à - pas : Ajouter une barre d'outils à l'IDE.

Composants requis

Pour exécuter cette procédure, vous devez installer Kit de développement logiciel Visual Studio 2010.

Notes

Pour plus d'informations sur le kit de développement Visual Studio, consultez Étendre la présentation de Visual Studio.Pour savoir comment télécharger le kit de développement Visual Studio, consultez Visual Studio Extensibility Developer Center sur le site Web MSDN.

Emplacements du modèle de projet de package Visual Studio

Le modèle de projet de package Visual Studio est disponible dans trois emplacements dans la boîte de dialogue de Nouveau projet :

sous Extensibilité Visual Basic. Le langage par défaut du projet est en Visual Basic.
sous Extensibilité c#. Le langage par défaut du projet est c#.
sous L'autre projet types l'extensibilité. Le langage par défaut du projet est en C++.

créer un VSPackage pour une fenêtre Outil

Cette section indique comment utiliser le modèle de projet de package de Visual Studio pour créer une fenêtre Outil VSPackage qui prend en charge une seule commande de menu.

pour créer le TWToolbar VSPackage

créez un VSPackage nommé la TWbarre d'outils. Pour plus d'informations, consultez Procédure pas - à - pas : Créer une commande de menu à l'aide de le modèle de package Visual Studio.
Définissez le langage de programmation à Visual Basic ou à Visual C#, puis sélectionnez les options de Commande de menu et de fenêtre Outil .
Sous options de commande, affectez le nom de la commande à ordre de TWTest, et l'ID de commande à cmdidTWTestCmd.
Sous options de fenêtre Outil, affectez le nom à fenêtre d'outil de test, et l'ID de commande à cmdidTestTool.

créer une barre d'outils pour une fenêtre Outil

Pour créer une barre d'outils de la fenêtre Outil

ouvrez TWToolbar.vsct dans l'éditeur de texte.
Dans la section d' Symbols , dans le nœud d' GuidSymbol nommé « guidTWToolbarCmdSet », déclarez une barre d'outils et un groupe de barre d'outils, comme suit.
```
<IDSymbol name="TWToolbar" value="0x1000" />
<IDSymbol name="TWToolbarGroup" value="0x1050" />
```
en haut de la section d' Commands , créez une section d' Menus .
```
<Menus></Menus>
```
la définition de barre d'outils est localisée ici parce que l'analyseur de VSCT ne distingue pas les menus et les barres d'outils à ce niveau.
Ajoutez un élément d' Menu dans la section de Menus pour définir la barre d'outils.
```
<Menu guid="guidTWToolbarCmdSet" id="TWToolbar" type="ToolWindowToolbar">
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
Les barres d'outils ne peuvent pas être imbriquées comme des sous-menus. par conséquent, vous ne devez pas affecter un parent. En outre, vous ne devez pas définir une priorité, car l'utilisateur peut déplacer des barres d'outils. En général, le positionnement initial d'une barre d'outils est défini par programme, mais les modifications suivantes par l'utilisateur sont persistantes.

Dans la section d' Groups , après l'entrée de groupe existant, définissez un groupe pour contenir les commandes de la barre d'outils.

<Group guid="guidTWToolbarCmdSet" id="TWToolbarGroup" priority="0x0000">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbar" />
</Group>

Dans la section d' Buttons , modifiez le parent de l'élément existant d' Button au groupe de barre d'outils pour que la barre d'outils s'affiche.
```
<Button guid="guidTWToolbarCmdSet" id="cmdidTWTestCommand" priority="0x0100" type="Button">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbarGroup" />
  <Icon guid="guidImages" id="bmpPic1" />
  <Strings>
    <CommandName>cmdidTWTestCmd</CommandName>
    <ButtonText>TWTest Command</ButtonText>
  </Strings>
</Button>
```
Par défaut, si une barre d'outils n'a pas de commandes, ne semble -t-il.

Étant donné que la nouvelle barre d'outils n'est pas ajoutée automatiquement à la fenêtre Outil par Visual Studio IDE, la barre d'outils doit être ajoutée par programme par le VSPackage elle-même. Cette opération est abordée dans la section suivante, « ajoutant une barre d'outils à la fenêtre Outil. »

Ajouter la barre d'outils à la fenêtre Outil

pour ajouter la barre d'outils à la fenêtre Outil

dans le projet de TWToolbar, ouvrez PkgCmdID.vb ou PkgCmdID.cs dans l'éditeur de texte.
Après les identificateurs existants de commande dans le fichier de PkgCmdID, ajoutez l'ID de commande suivante
```
public const int TWToolbar = 0x1000;
```
ouvrez MyToolWindow.vb ou MyToolWindow.cs dans l'éditeur de texte.
En haut du fichier, après l'autre Imports instructions ou d' using , ajoutez la ligne suivante.
```
using System.ComponentModel.Design; // for CommandID
```
dans le constructeur de classe d' MyToolWindow , au début du constructeur, ajoutez la ligne suivante.
```
this.ToolBar = new CommandID(
    GuidList.guidTWToolbarCmdSet,
    PkgCmdIDList.TWToolbar);
```
Ce code indique à (MPF) managed package la barre d'outils à créer lorsque la fenêtre Outil est créée.

Notes

En code managé, une seule barre d'outils peut être ajoutée à une fenêtre Outil.
Dans le menu Générer, cliquez sur Générer la solution pour générer la solution.

Test de la barre d'outils de la fenêtre Outil

Pour tester la barre d'outils de la fenêtre Outil

Appuyez sur F5 pour ouvrir une instance de Visual Studio expérimental en mode débogage.
Dans le menu d' Afficher , pointez sur Autres fenêtres puis cliquez sur fenêtre d'outil de test pour afficher la fenêtre Outil.

Notez qu'une barre d'outils s'affiche juste sous le titre de la fenêtre Outil.
Dans la barre d'outils de la fenêtre Outil, cliquez sur l'icône pour afficher le message « Company.TWToolbar.TW intérieur ToolbarPackage.MenuItemCallback() ».

Voir aussi

Tâches

Procédure pas - à - pas : Ajouter une barre d'outils à l'IDE

Autres ressources

Procédures pas - à - pas pour les commandes, de menus, et les barres d'outils

commandes, menus, et barres d'outils

Partager via