funzione ImageList_LoadImageA (commctrl.h)

Crea un elenco di immagini dalla bitmap specificata.

Sintassi

HIMAGELIST ImageList_LoadImageA(
  HINSTANCE hi,
  LPCSTR    lpbmp,
  int       cx,
  int       cGrow,
  COLORREF  crMask,
  UINT      uType,
  UINT      uFlags
);

Parametri

hi

Tipo: HINSTANCE

Handle per l'istanza che contiene la risorsa. Questo parametro può essere NULL se si carica un'immagine da un file o si carica una risorsa OEM.

lpbmp

Tipo: LPCTSTR

Immagine da caricare.

Se il parametro uFlags include LR_LOADFROMFILE, lpbmp è l'indirizzo di una stringa con terminazione Null che denomina il file contenente l'immagine da caricare.

Se il parametro hi è diverso da NULL e non viene specificato LR_LOADFROMFILE, lpbmp è l'indirizzo di una stringa con terminazione Null che contiene il nome della risorsa immagine nel modulo hi .

Se hi è NULL e non viene specificato LR_LOADFROMFILE, per caricare l'identificatore LOWORD di questo parametro deve essere l'identificatore di un'immagine OEM. Per creare questo valore, usare la macro MAKEINTRESOURCE con uno degli identificatori di immagine OEM definiti in Winuser.h. Questi identificatori hanno i prefissi seguenti.

cx

Tipo: int

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

cGrow

Tipo: int

Numero di immagini in base al quale l'elenco di immagini può aumentare 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, nel cursore o nell'icona 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. Se questo parametro è il valore CLR_DEFAULT, il colore del pixel nell'angolo superiore sinistro dell'immagine viene considerato come colore della maschera.

uType

Tipo: UINT

Flag che specifica il tipo di immagine da caricare. Questo parametro deve essere IMAGE_BITMAP per indicare che viene caricata una bitmap.

uFlags

Tipo: UINT

Flag che specificano come caricare l'immagine. Questo parametro può essere una combinazione dei valori seguenti.

Valore restituito

Tipo: HIMAGELIST

Restituisce l'handle all'elenco di immagini in caso di esito positivo o NULL in caso contrario.

Commenti

LR_LOADTRANSPARENT non carica l'immagine in modo trasparente. Crea un elenco di immagini opache che appare solo trasparente perché tutti i pixel di sfondo sono stati modificati in COLOR_WINDOW. Se le immagini vengono disegnate su uno sfondo diverso dal colore COLOR_WINDOW, l'immagine non viene disegnata correttamente. Inoltre, LR_LOADTRANSPARENT e LR_LOADMAP3DCOLORS usare i colori di sistema applicati al momento della chiamata a ImageList_LoadImage . Se i colori di sistema cambiano successivamente, l'applicazione deve ricaricare l'immagine per rieseguire il mapping dei colori.

Requisiti

Vedi anche

Loadimage