Comment : Créez les barres d'outils dans l'IDE

Article
05/17/2015

Vous pouvez ajouter une barre d'outils à l'environnement (IDE) de développement intégré en définissant un menu de type Toolbar dans un fichier d'un VSPackage .vsct.

Une barre d'outils possède les caractéristiques suivantes :

une barre d'outils est une horizontale ou une barre verticale qui contiennent des boutons. les boutons peuvent avoir une icône ou un texte, ou une combinaison d'icône et de texte.
Une barre d'outils peut être ancrée sur un bord de sa fenêtre parente.
L'IDE traite une barre d'outils VSPackage-fournie comme il traite les barres d'outils inclus dans Visual Studio. Le VSPackage ne doit rien faire par programme vérifier sa barre d'outils à reconnaître par la boîte de dialogue de Personnaliser . Si un utilisateur personnalise la barre d'outils, l'IDE suit automatiquement les modifications.
L'IDE fournit automatiquement à la barre d'outils à afficher sur le sous-menu de barres d'outils le menu pour Afficher afin que les utilisateurs puissent le masquer ou les afficher.
Une barre d'outils qui n'a pas de commande visible est automatiquement masquée.

Vous pouvez modifier ces caractéristiques en spécifiant des balises lorsque vous définissez la barre d'outils dans le fichier de .vsct, comme indiqué dans la procédure suivante.

Pour créer une barre d'outils dans l'IDE

Créez un package en exécutant le modèle de package Visual Studio. Suivez les instructions de package-création dans Procédure pas - à - pas : Ajouter une barre d'outils à l'IDE.
ouvrez le fichier de .vsct dans l'éditeur. Dans la section qui est formée par la section de symboles , recherchez l'élément de GuidSymbol qui contient vos menus, groupes, et commandes.
Comme le montre l'exemple suivant, ajoutez un élément de IDSymbol de chacun de ces membres : une barre d'outils, un groupe de commandes, et une ou plusieurs commandes.
```
<IDSymbol name="MyMenuGroup" value="0x1020" />
<IDSymbol name="cmdidTestCmd" value="0x0100" />
<IDSymbol name="Toolbar" value="0x1000" />
<IDSymbol name="ToolbarGroup" value="0x1050" />
```
Les attributs d' name des éléments d' GuidSymbol et d' IDSymbol à une barre d'outils, à une commande, ou un groupe défini fournissent un GUID : Paire d'ID qui représente cette barre d'outils, commande, ou groupe. GUID représente un jeu de commandes qui est défini pour votre VSPackage. Plusieurs jeux de commandes peuvent être définis dans le package. GUID : Les paires d'ID qui sont utilisées pour identifier chaque élément doivent être uniques.
Juste au-dessus de la section qui est formée par la section de groupes , créez une section de menus .
Définissez la barre d'outils en tant qu'élément de menu dans la section d' Menus , comme suit :
1. Définir les attributs d' guid et d' id à un GUID : ID de la nouvelle barre d'outils.
2. définissez l'attribut d' priority (facultatif).
  
  L'attribut d' priority est généralement omis pour une barre d'outils car il peut être déplacé par les utilisateurs. Omettre l'attribut d' priority a le même effet que le affectant à 0. Toutefois, si la même fenêtre a plusieurs barres d'outils, vous pouvez assigner leur position de départ en définissant leurs priorités.
3. définissez l'attribut d' type à barre d'outils.
4. Dans l'élément d' Menu , utilisez l'élément de chaînes pour créer une section qui contient un élément de ButtonText et un élément de CommandName . L'élément d' ButtonText est utilisé pour définir le nom de la barre d'outils qu'il apparaît dans l'IDE. L'élément d' CommandName est utilisé pour définir le nom de la commande qui peut être entré dans la fenêtre de Commande pour accéder à la barre d'outils.
  
  si vous souhaitez ajouter des balises de commande, ajoutez un élément de CommandFlag pour chacun.
  
  Pour une description des valeurs d'indicateur de commande, consultez CommandFlag, élément.
l'exemple suivant définit une barre d'outils.
```
<Menu guid="guidIDEToolbarCmdSet" id="Toolbar"
      type="Toolbar" >
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>
```
Notes

Vous ne devez pas définir un parent pour un menu de type Toolbar car il est automatiquement mis dans l'IDE.Tout paramètre pour le parent est ignoré.
Dans la section qui est formée par la section de groupes , créez un élément de groupe pour contenir les commandes que vous souhaitez voir apparaître dans votre barre d'outils.
1. Définissez la priorité du groupe pour déterminer où il s'affiche dans votre barre d'outils.
  
  Un groupe qui possède un paramètre de priorité inférieure apparaît sur le côté gauche de la barre d'outils (ou supérieure, selon la façon dont la barre d'outils est orientée).
2. Définissez le parent du groupe à un GUID : ID de la barre d'outils.
Le groupe suivant apparaît dans la barre d'outils.
```
<Group guid="guidIDEToolbarCmdSet" id="ToolbarGroup"
      priority="0x0000">
  <Parent guid="guidIDEToolbarCmdSet" id="Toolbar"/>
</Group>
```
Ajoutez les commandes de la barre d'outils en créant des entrées de commande dans la section qui est formée par la section de boutons . Définissez le parent de chaque entrée command à un GUID : ID du groupe. Chaque élément de bouton doit avoir une paire GUID : ID qui correspond à une entrée dans la section d' Symbols .

Utilisez l'attribut de priority de chaque entrée de bouton pour spécifier où la commande apparaîtra au groupe.

L'exemple suivant définit un bouton qui apparaîtra dans la barre d'outils.
```
<Button guid="guidIDEToolbarCmdSet" id="cmdidTestCmd" priority="0x0100" type="Button">
  <Parent guid="guidIDEToolbarCmdSet" id="ToolbarGroup" />
  <Icon guid="guidImages" id="bmpPic1" />
  <Strings>
    <CommandName>cmdidTestCmd</CommandName>
    <ButtonText>Toolbar Test Command</ButtonText>
  </Strings>
</Button>
```
Pour plus d'informations sur les boutons et des éléments de menu, consultez le Button, élément.