Funzione ImageList_ReplaceIcon (commctrl.h)

Articolo
02/26/2024

Sostituisce un'immagine con un'icona o un cursore.

Sintassi

int ImageList_ReplaceIcon(
  [in] HIMAGELIST himl,
  [in] int        i,
  [in] HICON      hicon
);

Parametri

[in] himl

Tipo: HIMAGELIST

Handle per l'elenco di immagini.

[in] i

Tipo: int

Indice dell'immagine da sostituire. Se i è -1, la funzione aggiunge l'immagine alla fine dell'elenco.

[in] hicon

Tipo: HICON

Handle per l'icona o il cursore che contiene la bitmap e la maschera per la nuova immagine.

Valore restituito

Tipo: int

Restituisce l'indice dell'immagine se ha esito positivo o -1 in caso contrario.

Commenti

Poiché il sistema non salva hicon, è possibile eliminarlo dopo che la funzione restituisce se l'icona o il cursore è stato creato dalla funzione CreateIcon . Non è necessario eliminare hicon se è stato caricato dalla funzione LoadIcon ; il sistema libera automaticamente una risorsa icona quando non è più necessaria.

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
Set di API	ext-ms-win-shell-comctl32-init-l1-1-1 (introdotta in Windows 10, versione 10.0.14393)

Condividi tramite