macro ImageList_AddIcon (commctrl.h)

Aggiunge un'icona o un cursore a un elenco di immagini. ImageList_AddIcon chiama la funzione ImageList_ReplaceIcon .

Sintassi

int ImageList_AddIcon(
   HIMAGELIST himl,
   HICON      hicon
);

Parametri

himl

Tipo: HIMAGELIST

Handle per l'elenco di immagini. Se questo parametro identifica un elenco di immagini mascherate, la macro copia sia le bitmap dell'immagine che della maschera dell'icona o del cursore. Se questo parametro identifica un elenco di immagini non mascherate, la macro copia solo la bitmap dell'immagine.

hicon

Tipo: HICON

Handle per l'icona o il cursore che contiene la bitmap e la maschera per la nuova immagine.

Valore restituito

Tipo: int

Restituisce l'indice dell'immagine in caso di esito positivo o -1 in caso contrario.

Commenti

Poiché il sistema non salva hicon, è possibile eliminarlo dopo che la macro restituisce se l'icona o il cursore è stato creato dalla funzione CreateIcon . Non è necessario distruggere hicon se è stato caricato dalla funzione LoadIcon ; il sistema libera automaticamente una risorsa icona quando non è più necessaria.

La macro ImageList_AddIcon è definita come segue:

#define  ImageList_AddIcon(himl, hicon) ImageList_ReplaceIcon(himl, -1, hicon)

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h