funzione ImageList_Replace (commctrl.h)

Sostituisce un'immagine in un elenco di immagini con una nuova immagine.

Sintassi

BOOL ImageList_Replace(
  HIMAGELIST himl,
  int        i,
  HBITMAP    hbmImage,
  HBITMAP    hbmMask
);

Parametri

himl

Tipo: HIMAGELIST

Handle per l'elenco di immagini.

i

Tipo: int

Indice dell'immagine da sostituire.

hbmImage

Tipo: HBITMAP

Handle per la bitmap che contiene l'immagine.

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.

Valore restituito

Tipo: BOOL

Restituisce un valore diverso da zero se l'operazione ha esito positivo o zero in caso contrario.

Commenti

La funzione ImageList_Replace 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

   
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