Metodo IImageList::ReplaceIcon (commoncontrols.h)

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

Sintassi

HRESULT ReplaceIcon(
  [in]  int   i,
  [in]  HICON hicon,
  [out] int   *pi
);

Parametri

[in] i

Tipo: int

Valore di tipo int che contiene l'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.

[out] pi

Tipo: int*

Puntatore a un int che conterrà l'indice dell'immagine in caso di esito positivo o -1 in caso contrario.

Valore restituito

Tipo: HRESULT

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

Commenti

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

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

Requisiti