Função CreateMappedBitmap (commctrl.h)

Cria um bitmap para uso em uma barra de ferramentas.

Sintaxe

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

Parâmetros

hInstance

Tipo: HINSTANCE

Manipule para a instância do módulo com o arquivo executável que contém o recurso bitmap.

idBitmap

Tipo: INT_PTR

Identificador de recurso do recurso bitmap.

wFlags

Tipo: UINT

Sinalizador de bitmap. Esse parâmetro pode ser zero ou o seguinte valor:

Valor	Significado
CMB_MASKED	Usa um bitmap como máscara.

[in] lpColorMap

Tipo: LPCOLORMAP

Ponteiro para uma estrutura COLORMAP que contém as informações de cor necessárias para mapear os bitmaps. Se esse parâmetro for NULL, a função usará o mapa de cores padrão.

iNumMaps

Tipo: int

Número de mapas de cores apontados por lpColorMap.

Retornar valor

Tipo: HBITMAP

Retorna o identificador para o bitmap se tiver êxito ou NULL caso contrário. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

A função cria um novo bitmap usando os dados e as cores do bitmap especificados pelo recurso bitmap e as informações de mapeamento de cores.

Essa função tem suporte total apenas para imagens com mapas de cores; ou seja, imagens com 256 ou menos cores.

Exemplos

O código de exemplo a seguir cria um bitmap de um recurso e faz com que a cor preta apareça transparente mapeando-a para a cor do sistema para uma face de botão.

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	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h
Biblioteca	Comctl32.lib
DLL	Comctl32.dll
Conjunto de APIs	ext-ms-win-shell-comctl32-init-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)