macro ImageList_LoadBitmap (commctrl.h)

Chiama la funzione ImageList_LoadImage per creare un elenco di immagini dalla risorsa bitmap specificata.

Sintassi

HIMAGELIST ImageList_LoadBitmap(
   HINSTANCE hi,
   LPCTSTR   lpbmp,
   int       cx,
   int       cGrow,
   COLORREF  crMask
);

Parametri

hi

Tipo: HINSTANCE

Handle per l'istanza che contiene la risorsa bitmap. Questo parametro è NULL se si sta caricando una bitmap OEM.

lpbmp

Tipo: LPCTSTR

Immagine da caricare. Se il parametro hi non èNULL, lpbmp è l'indirizzo di una stringa con terminazione Null contenente il nome della risorsa immagine nel modulo hi . Se hi è null, il LOWORD di questo parametro deve essere l'identificatore di una bitmap OEM da caricare. Per creare questo valore, usare la macro MAKEINTRESOURCE con uno degli identificatori bitmap OEM definiti in WINUSER.H. Questi identificatori hanno il prefisso OBM_.

cx

Tipo: int

Larghezza di ogni immagine. L'altezza di ogni immagine e il numero iniziale di immagini vengono dedotti dalle dimensioni della bitmap specificata.

cGrow

Tipo: int

Numero di immagini in base alle quali l'elenco di immagini può crescere quando il sistema deve fare spazio alle nuove immagini. Questo parametro rappresenta il numero di nuove immagini che l'elenco di immagini ridimensionate può contenere.

crMask

Tipo: COLORREF

Colore utilizzato per generare una 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 è il valore CLR_NONE, non viene generata alcuna maschera.

Valore restituito

Tipo: HIMAGELIST

Restituisce l'handle all'elenco di immagini in caso di esito positivo oppure null in caso contrario.

Fabbisogno