Función CreateMappedBitmap (commctrl.h)

Crea un mapa de bits para usarlo en una barra de herramientas.

Sintaxis

HBITMAP CreateMappedBitmap(
       HINSTANCE  hInstance,
       INT_PTR    idBitmap,
       UINT       wFlags,
  [in] LPCOLORMAP lpColorMap,
       int        iNumMaps
);

Parámetros

hInstance

Tipo: HINSTANCE

Controle la instancia del módulo con el archivo ejecutable que contiene el recurso de mapa de bits.

idBitmap

Tipo: INT_PTR

Identificador de recurso del recurso de mapa de bits.

wFlags

Tipo: UINT

Marca de mapa de bits. Este parámetro puede ser cero o el siguiente valor:

Valor	Significado
CMB_MASKED	Usa un mapa de bits como máscara.

[in] lpColorMap

Tipo: LPCOLORMAP

Puntero a una estructura COLORMAP que contiene la información de color necesaria para asignar los mapas de bits. Si este parámetro es NULL, la función usa el mapa de colores predeterminado.

iNumMaps

Tipo: int

Número de mapas de color a los que apunta lpColorMap.

Valor devuelto

Tipo: HBITMAP

Devuelve el identificador al mapa de bits si se ejecuta correctamente o NULL de lo contrario. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

La función crea un nuevo mapa de bits con los datos y colores del mapa de bits especificados por el recurso de mapa de bits y la información de asignación de colores.

Esta función solo se admite para imágenes con mapas de color; es decir, imágenes con 256 o menos colores.

Ejemplos

El código de ejemplo siguiente crea un mapa de bits a partir de un recurso y hace que el color negro aparezca transparente mediante su asignación al color del sistema para una cara de botón.

DWORD backgroundColor = GetSysColor(COLOR_BTNFACE);
COLORMAP colorMap;
colorMap.from = RGB(0, 0, 0);
colorMap.to = backgroundColor;
HBITMAP hbm = CreateMappedBitmap(g_hInst, IDB_BITMAP1, 0, &colorMap, 1);

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commctrl.h
Library	Comctl32.lib
Archivo DLL	Comctl32.dll
Conjunto de API	ext-ms-win-shell-comctl32-init-l1-1-1 (introducido en Windows 10, versión 10.0.14393)