Metodo IImageList::Replace (commoncontrols.h)

Articolo
02/28/2024

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

Sintassi

HRESULT Replace(
  [in]           int     i,
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask
);

Parametri

[in] i

Tipo: int

Valore di tipo int contenente l'indice dell'immagine da sostituire.

[in] hbmImage

Tipo: HBITMAP

Handle alla bitmap contenente l'immagine.

[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.

Valore restituito

Tipo: HRESULT

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

Commenti

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

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commoncontrols.h
DLL	Comctl32.dll (versione 6.0 o successiva)

Condividi tramite