macro ListView_SetImageList (commctrl.h)

Assegna un elenco di immagini a un controllo visualizzazione elenco. È possibile utilizzare questa macro o inviare il messaggio di LVM_SETIMAGELIST in modo esplicito.

Sintassi

HIMAGELIST ListView_SetImageList(
   HWND       hwnd,
   HIMAGELIST himl,
   int        iImageList
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

himl

Tipo: HIMAGELIST

Handle per l'elenco di immagini da assegnare.

iImageList

Tipo: int

Tipo di elenco di immagini. Questo parametro può essere uno dei valori seguenti:

Valore	Significato
LVSIL_NORMAL	Elenco di immagini con icone di grandi dimensioni.
LVSIL_SMALL	Elenco di immagini con icone piccole.
LVSIL_STATE	Elenco di immagini con immagini di stato.
LVSIL_GROUPHEADER	Elenco di immagini per l'intestazione di gruppo.

Valore restituito

Tipo: HIMAGELIST

Restituisce l'handle all'elenco di immagini precedentemente associato al controllo se ha esito positivo oppure null in caso contrario.

Osservazioni

L'elenco di immagini corrente verrà eliminato definitivamente quando il controllo visualizzazione elenco viene eliminato definitivamente a meno che non venga impostato lo stile LVS_SHAREIMAGELISTS. Se si usa questo messaggio per sostituire un elenco di immagini con un altro, l'applicazione deve eliminare in modo esplicito tutti gli elenchi di immagini diversi da quello corrente.

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