Elemento de mapa de bitsBitmap Element

Define un mapa de bits.Defines a bitmap. El mapa de bits se carga desde un recurso o desde un archivo.The bitmap is loaded either from a resource or from a file.

SintaxisSyntax

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

Atributos y elementosAttributes and Elements

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescripciónDescription
guidguid Requerido.Required. GUID del identificador de comando/identificador GUID.GUID of the GUID/ID command identifier.

El atributo guid de un mapa de bits no está asociado con cualquier VSPackage u otro grupo de comandos.The guid attribute for a bitmap is not associated with any VSPackage or other command group. Debe ser único para la definición de mapa de bits y no debe usarse para ningún otro propósito.It should be unique to the bitmap definition and should not be used for any other purpose.
resIDresID Id. del identificador de comando/identificador GUID.ID of the GUID/ID command identifier. Se requiere el resID o el atributo href.Either the resID or the href attribute is required.

El atributo resID es un identificador de recurso de entero que determina la franja de mapa de bits que debe cargarse durante la tabla de comandos de combinación.The resID attribute is an integer resource ID that determines the bitmap strip that is to be loaded during command table merging. Cuando se carga la tabla de comandos, los mapas de bits especificado por el identificador de recurso se cargará desde el recurso del mismo módulo.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 Obligatorio si está presente el atributo resID.Required if the resID attribute is present. Selecciona las imágenes disponibles en la franja de mapa de bits.Selects the available images in the bitmap strip.
hrefhref Ruta de acceso al mapa de bits.Path to the bitmap. Se requiere el resID o el atributo href.Either the resID or the href attribute is required.

La ruta de acceso de inclusión se busca el archivo de imagen indicado, que está incrustado en el binario resultante.The include path is searched for the indicated image file, which is embedded in the resulting binary. Durante la combinación de tabla de comandos, se copia la imagen y no se requiere ninguna búsqueda de recursos adicionales o carga.During the command table merge, the image is copied and no additional resource lookup or load is required. Si no está presente el atributo usedList, están disponibles todas las imágenes en la franja.If the usedList attribute is not present, all images in the strip are available. Nota: imágenes pueden proporcionarse en uno de los distintos formatos que incluyen .bmp, .png y .gif.Note: Images may be supplied in one of several formats that include .bmp, .png, and .gif. Las versiones anteriores del compilador no era compatible con imágenes de mapa de bits de 32 bits que tenían información alfa para la transparencia parcial.Earlier versions of the compiler did not support 32-bit bitmap images that had alpha information for partial transparency. La solución para estas versiones es utilizar el formato. png.The workaround for these versions is to use the .png format.
CondiciónCondition Opcional.Optional. Vea atributos condicionales.See Conditional Attributes.

Elementos secundariosChild Elements

Ninguno.None.

Elementos primariosParent Elements

ElementoElement DescripciónDescription
Bitmaps (Elemento)Bitmaps Element Agrupa elementos de mapa de bits.Groups Bitmap elements.

EjemploExample

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

Vea tambiénSee Also

Archivos de tabla de comandos de Visual Studio (.Vsct)Visual Studio Command Table (.Vsct) Files