funzione ImageList_Replace (commctrl.h)

Articolo
08/22/2023

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

Condividi tramite