Élément de bitmapBitmap element

Définit une image bitmap.Defines a bitmap. La bitmap est chargée à partir d’une ressource ou d’un fichier.The bitmap is loaded either from a resource or from a file.

SyntaxeSyntax

<Bitmap guid="guidImages" href="images\MyImage.bmp" usedList="bmp1, bmp2, bmp3" />  

Attributs et élémentsAttributes and elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
GUIDguid Obligatoire.Required. GUID de l’identificateur de commande/ID GUID.GUID of the GUID/ID command identifier.

L’attribut de guid pour une image bitmap n’est pas associé à n’importe quel package Visual Studio ou l’autre groupe de commandes.The guid attribute for a bitmap is not associated with any VSPackage or other command group. Il doit être unique à la définition de bitmap et ne doit pas être utilisé à d’autres fins.It should be unique to the bitmap definition and should not be used for any other purpose.
resIDresID ID de l’identificateur de commande/ID GUID.ID of the GUID/ID command identifier. Le resID ou l’attribut href est requis.Either the resID or the href attribute is required.

L’attribut resID est un ID de ressource d’entier qui détermine la bande de bitmaps qui doit être chargé pendant la fusion des tables de commande.The resID attribute is an integer resource ID that determines the bitmap strip that is to be loaded during command table merging. Lorsque la table de commande est chargée, les bitmaps spécifiées par l’ID de ressource sera chargées à partir de la ressource du même module.When the command table is being loaded, the bitmaps specified by the resource ID will be loaded from the resource of the same module.
usedListusedList Obligatoire si l’attribut resID n’est présent.Required if the resID attribute is present. Sélectionne les images disponibles dans la bande de bitmaps.Selects the available images in the bitmap strip.
hrefhref Chemin d’accès à l’image bitmap.Path to the bitmap. Le resID ou l’attribut href est requis.Either the resID or the href attribute is required.

Le chemin d’accès include est recherchés dans le fichier image indiqué, qui est incorporé dans le fichier binaire qui en résulte.The include path is searched for the indicated image file, which is embedded in the resulting binary. Pendant la fusion de table de commande, l’image est copiée et aucune recherche de ressources supplémentaires ou de la charge n’est nécessaire.During the command table merge, the image is copied and no additional resource lookup or load is required. Si l’attribut usedList n’est pas présent, toutes les images dans la bande sont disponibles.If the usedList attribute is not present, all images in the strip are available. Remarque : Images peuvent être fournies dans un des formats qui incluent .bmp, .png, et .gif.Note: Images may be supplied in one of several formats that include .bmp, .png, and .gif. Les versions antérieures du compilateur ne prenait pas en charge les images bitmap 32 bits qui avait des informations alpha pour la transparence partielle.Earlier versions of the compiler did not support 32-bit bitmap images that had alpha information for partial transparency. La solution de contournement pour ces versions consiste à utiliser le .png format.The workaround for these versions is to use the .png format.
ConditionCondition Facultatif.Optional. Consultez attributs conditionnels.See Conditional attributes.

Éléments enfantsChild elements

Aucun.None.

Éléments parentsParent elements

ÉlémentElement DescriptionDescription
Élément bitmapsBitmaps element Regroupe les éléments de la Bitmap.Groups Bitmap elements.

ExempleExample

<Bitmap guid="guidWidgetIcons" href="WidgetToolbarIcons_32.bmp" />  
<Bitmap guid="guidWidgetIcons2" resID="IDBMP_WIDGETICONS"  
  usedList="1, 2, 3, 4"/>  

Voir aussiSee also

Visual Studio fichiers command table (.vsct)Visual Studio command table (.vsct) files