Metodo IImageList::Add (commoncontrols.h)

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

Sintassi

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

Parametri

[in] hbmImage

Tipo: HBITMAP

Handle alla bitmap contenente l'immagine o le immagini. Il numero di immagini viene dedotto dalla larghezza della bitmap.

[in, optional] hbmMask

Tipo: HBITMAP

Handle alla bitmap contenente la maschera. Se non viene usata alcuna maschera con l'elenco di immagini, questo parametro viene ignorato.

[out] pi

Tipo: int*

Quando questo metodo restituisce, contiene un puntatore all'indice della prima nuova immagine. Se il metodo non riesce a aggiungere correttamente la nuova immagine, questo valore è -1.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

IImageList::Add copia la bitmap in una struttura dati interna. È necessario usare la funzione DeleteObject per eliminare hbmImage e hbmMask dopo che il metodo restituisce.

Per usare IImageList::Add, specificare Comctl32.dll versione 6 nel manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.

Requisiti