Partager via

Comment : Ajoutez les icônes aux commandes des barres d'outils

  • Article

Les commandes peuvent apparaître dans les menus et les barres d'outils. Sur les barres d'outils, il est fréquent qu'une commande s'affiche avec une seule icône (pour économiser de l'espace) alors que dans les menus une commande apparaît généralement avec une icône et du texte.

Les icônes sont 16 pixels en largeur et de 16 pixels en hauteur et peuvent être profondeur de couleur 8 bits (256 couleurs) ou profondeur de couleur 32 bits (couleurs vraies.) les icônes de couleurs 32 bits sont préférées. Les icônes sont généralement réorganisées dans une ligne horizontale unique dans une seule bitmap, bien qu'il permette plusieurs bitmaps. cette bitmap est déclarée dans le fichier de .vsct avec les différentes icônes disponibles dans la bitmap. Consultez la référence pour Bitmaps, élément pour plus de détails.

ajouter une icône à une commande

pour ajouter une icône à une commande

  1. Créez une bitmap avec une profondeur de couleur de 32 bits. Une icône est toujours 16 x 16 donc cette bitmap doit être de 16 pixels en hauteur et un multiple de 16 pixels.

    Chaque icône est placée dans la bitmap l'un à l'autre sur une seule ligne. Utilisez le canal alpha pour indiquer les emplacements de la transparence dans chaque icône.

    Si vous utilisez une profondeur de couleur 8 bits, magenta d'utilisation, RGB(255,0,255), comme transparence. Toutefois, les icônes de couleurs 32 bits sont préférées.

  2. ouvrez le fichier de .vsct dans l'éditeur.

  3. Dans Symbols, élément, recherchez GuidSymbol, élément qui contient les entrées de bitmap existantes. Par défaut, il est nommé guidImages.

    L'exemple suivant illustre l'élément d' <GuidSymbol> par défaut généré par le modèle de package Visual Studio.

    <GuidSymbol name="guidImages" value="{7f2b0178-a581-424f-933f-f6da41774269}">
  <IDSymbol name="bmpPic1" value="1" />
  <IDSymbol name="bmpPic2" value="2" />
  <IDSymbol name="bmpPicSearch" value="3" />
  <IDSymbol name="bmpPicX" value="4" />
  <IDSymbol name="bmpPicArrows" value="5" />
</GuidSymbol>

  4. ajoutez IDSymbol, élément pour chaque icône dans votre bitmap. L'attribut d' name est l'ID de l'icône, puis value indique sa position sur la bande.

  5. créez Bitmap, élément dans la section d' <Bitmaps> du fichier de .vsct pour représenter la bitmap contenant les icônes.

    • Définissez la valeur de guid au nom de l'élément d' <GuidSymbol> qui contient vos déclarations de bitmap.

    • Définissez l'attribut d' href au chemin d'accès relatif du fichier bitmap, ou affectez à l'attribut d' resID à une ressource entière, affectez ailleurs dans le package, qui fait référence aux bitmap souhaitées.

    • Vous pouvez améliorer les performances en définissant l'attribut d' usedList une liste délimitée par des virgules des icônes à utiliser dans le VSPackage. Les icônes pas sur la liste sont compilation exclue de formulaire. Vous devez spécifier un usedList si vous utilisez un resID au lieu d'un href.

    L'exemple suivant illustre une entrée par défaut créé par le modèle de package.

    <Bitmap guid="guidImages" href="Resources\Images_32bit.bmp" usedList="bmpPic1, bmpPic2, bmpPicSearch, bmpPicX, bmpPicArrows" />

  6. créez Button, élément dans Buttons, élément ou utilisez une entrée existante.

    • À l'intérieur de l'élément d' <Button> , ajoutez Icon, élément et définissez son guid et id attributs GUID : ID d'une des icônes dans votre bitmap.

    • Si vous le souhaitez, ajoutez l'une des balises suivantes à la définition du bouton comme CommandFlag, élément:

      IconAndText: l'icône et le texte du bouton sont affichés dans le menu et la barre d'outils.

      Pict: Seul l'icône de la commande est indiquée sur une barre d'outils alors que seul le texte de la commande est affiché dans un menu. Si une icône n'est pas spécifiée, un espace est indiqué sur une barre d'outils.

      TextOnly: seul le texte de la commande est indiqué sur une barre d'outils ou de menu. l'élément d' <Icon> est ignoré.

      Pour plus d'informations sur les balises de commande, <CommandFlag> consultez la documentation de l'élément.

Voir aussi

Concepts

Référence du schéma XML VSCT

Autres ressources

Tâches courantes avec des commandes, des menus, et les barres d'outils