Funzione CreateMappedBitmap (commctrl.h)

Articolo
02/28/2024

Crea una bitmap da usare in una barra degli strumenti.

Sintassi

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

Parametri

hInstance

Tipo: HINSTANCE

Gestire l'istanza del modulo con il file eseguibile che contiene la risorsa bitmap.

idBitmap

Tipo: INT_PTR

Identificatore di risorsa della risorsa bitmap.

wFlags

Tipo: UINT

Flag bitmap. Questo parametro può essere zero o il valore seguente:

Valore	Significato
CMB_MASKED	Usa una bitmap come maschera.

[in] lpColorMap

Tipo: LPCOLORMAP

Puntatore a una struttura COLORMAP contenente le informazioni sul colore necessarie per eseguire il mapping delle bitmap. Se questo parametro è NULL, la funzione usa la mappa dei colori predefinita.

iNumMaps

Tipo: int

Numero di mappe dei colori a cui punta lpColorMap.

Valore restituito

Tipo: HBITMAP

Restituisce l'handle alla bitmap se ha esito positivo o NULL in caso contrario. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

La funzione crea una nuova bitmap usando i dati bitmap e i colori specificati dalla risorsa bitmap e dalle informazioni sul mapping dei colori.

Questa funzione è completamente supportata solo per le immagini con mappe a colori; ovvero immagini con 256 o meno colori.

Esempio

Il codice di esempio seguente crea una bitmap da una risorsa e rende trasparente il colore nero mappandolo al colore di sistema per un viso del pulsante.

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);

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h
Libreria	Comctl32.lib
DLL	Comctl32.dll
Set di API	ext-ms-win-shell-comctl32-init-l1-1-1 (introdotta in Windows 10, versione 10.0.14393)

Condividi tramite