funzione ImageList_LoadImageA (commctrl.h)

Articolo
08/22/2023

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 non ènull e non viene specificato LR_LOADFROMFILE, lpbmp è l'indirizzo di una stringa con terminazione Null contenente il nome della risorsa immagine nel modulo hi.

Se hi è NULL e LR_LOADFROMFILE non è specificato, il LOWORD di questo parametro deve essere l'identificatore di un'immagine OEM da caricare. 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.

Valore	Significato
OBM_ per le bitmap OEM
OIC_ per le icone OEM
OCR_ per i cursori OEM

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 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, 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 è in corso il caricamento di una bitmap.

La notaImageList_LoadImage è destinata all'uso solo con i file bitmap. Non sono supportati altri tipi di immagine.

Valore	Significato
IMAGE_BITMAP	Carica una bitmap.

uFlags

Tipo: UINT

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

Valore	Significato
LR_CREATEDIBSECTION	Fa in modo che la funzione restituisca una bitmap di sezione DIB anziché una bitmap compatibile quando il parametro uType specifica IMAGE_BITMAP. LR_CREATEDIBSECTION è utile per caricare una bitmap senza mapparla ai colori del dispositivo di visualizzazione.
LR_DEFAULTCOLOR	Usa il formato di colore della visualizzazione.
LR_DEFAULTSIZE	Usa la larghezza o l'altezza specificata dai valori delle metriche di sistema per cursori e icone se il parametro cx è impostato su zero. Se questo valore non viene specificato e cx è impostato su zero, la funzione imposta le dimensioni su quello specificato nella risorsa. Se la risorsa contiene più immagini, la funzione imposta le dimensioni su quella della prima immagine.
LR_LOADFROMFILE	Carica l'immagine dal file specificato dal parametro lpbmp.
LR_LOADMAP3DCOLORS	Cerca nella tabella colori l'immagine e sostituisce le sfumature di grigio seguenti con il colore tridimensionale corrispondente: Grigio Dk: RGB(128, 128, 128)COLOR_3DSHADOW Grigio: RGB(192, 192, 192)COLOR_3DFACE Lt Grigio: RGB(223, 223, 223)COLOR_3DLIGHT Per altre informazioni, vedere la sezione Osservazioni.
LR_LOADTRANSPARENT	Recupera il valore del colore del primo pixel nell'immagine e sostituisce la voce corrispondente nella tabella dei colori con il colore predefinito della finestra (il colore visualizzato COLOR_WINDOW). Tutti i pixel dell'immagine che usano tale colore diventano il colore predefinito del valore della finestra. Questo valore si applica solo alle immagini con una tabella colori corrispondente. Per altre informazioni, vedere la sezione Osservazioni.
LR_MONOCHROME	Carica l'immagine in bianco e nero.
LR_SHARED	Condivide l'handle dell'immagine se l'immagine viene caricata più volte. Non usare questo valore per le immagini con dimensioni nontradizionali che potrebbero cambiare dopo il caricamento o per le immagini caricate da un file.

Valore restituito

Tipo: HIMAGELIST

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

Osservazioni

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 effettivi al momento della chiamata di ImageList_LoadImage. Se i colori di sistema cambiano successivamente, l'applicazione deve ricaricare l'immagine per rieseguire il mapping dei colori.

Nota

L'intestazione commctrl.h definisce ImageList_LoadImage come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h
libreria	Comctl32.lib
dll	Comctl32.dll

Vedere anche

LoadImage

Condividi tramite