Condividi tramite


Funzione ImageList_AddMasked (commctrl.h)

Aggiunge un'immagine o immagini a un elenco di immagini, generando una maschera dalla bitmap specificata.

Sintassi

int ImageList_AddMasked(
  HIMAGELIST himl,
  HBITMAP    hbmImage,
  COLORREF   crMask
);

Parametri

himl

Tipo: HIMAGELIST

Handle per l'elenco di immagini.

hbmImage

Tipo: HBITMAP

Handle alla bitmap contenente una o più immagini. Il numero di immagini viene dedotto dalla larghezza della bitmap.

crMask

Tipo: COLORREF

Colore utilizzato per generare la maschera. Ogni pixel di questo colore nella bitmap specificata viene modificato in nero e il bit corrispondente nella maschera è impostato su 1. Se questo parametro è CLR_DEFAULT, il colore del pixel in corrispondenza (0,0) viene usato come maschera.

Valore restituito

Tipo: int

Restituisce l'indice della prima immagine se ha esito positivo o -1 in caso contrario.

Commenti

La funzione ImageList_AddMasked copia la bitmap in una struttura di dati interna. Le bitmap con profondità di colore maggiore di 8bpp non sono supportate. Assicurarsi di usare la funzione DeleteObject per eliminare hbmImage dopo che la funzione restituisce.

Requisiti

   
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)