funzione ImageList_Add (commctrl.h)

Articolo
02/24/2024

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

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
Libreria	Comctl32.lib
DLL	Comctl32.dll

Condividi tramite