funzione ImageList_Add (commctrl.h)

Aggiunge un'immagine o immagini a un elenco di immagini.

Sintassi

int ImageList_Add(
  [in]           HIMAGELIST himl,
  [in]           HBITMAP    hbmImage,
  [in, optional] HBITMAP    hbmMask
);

Parametri

[in] himl

Tipo: HIMAGELIST

Handle per l'elenco di immagini.

[in] hbmImage

Tipo: HBITMAP

Handle per la bitmap che contiene l'immagine o le immagini. Il numero di immagini viene dedotto dalla larghezza della bitmap.

[in, optional] hbmMask

Tipo: HBITMAP

Handle per la bitmap che contiene la maschera. Se non viene utilizzata alcuna maschera con l'elenco di immagini, questo parametro viene ignorato. Questo parametro può essere NULL.

Valore restituito

Tipo: int

Restituisce l'indice della prima nuova immagine in caso di esito positivo o -1 in caso contrario.

Commenti

La funzione ImageList_Add copia la bitmap in una struttura di dati interna. Assicurarsi di usare la funzione DeleteObject per eliminare hbmImage ehbmMask dopo la restituzione della funzione.

Requisiti