Metodo IImageList::SetOverlayImage (commoncontrols.h)

Articolo
02/26/2024

Aggiunge un'immagine specificata all'elenco di immagini usate come maschere di sovrapposizione. Un elenco di immagini può avere fino a quattro maschere di sovrapposizione in Controlli comuni versione 4.70 e versioni precedenti e fino a 15 nella versione 4.71 o successiva. Il metodo assegna un indice di maschera di sovrapposizione all'immagine specificata.

Sintassi

HRESULT SetOverlayImage(
  [in] int iImage,
  [in] int iOverlay
);

Parametri

[in] iImage

Tipo: int

Valore di tipo int contenente l'indice in base zero di un'immagine nell'elenco di immagini. Questo indice identifica l'immagine da usare come maschera di sovrapposizione.

[in] iOverlay

Tipo: int

Valore di tipo int che contiene l'indice basato su uno della maschera di sovrapposizione.

Valore restituito

Tipo: HRESULT

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

Commenti

Una maschera di sovrapposizione è un'immagine disegnata in modo trasparente su un'altra immagine. Per disegnare una maschera di sovrapposizione su un'immagine, chiamare IImageList::D raw. Il parametro fStyle di queste funzioni può usare la macro INDEXTOOVERLAYMASK per specificare un indice di maschera di sovrapposizione.

Una chiamata a questo metodo non riesce e restituisce E_INVALIDARG a meno che l'elenco di immagini non venga creato usando una maschera.

Per usare IImageList::SetOverlayImage, 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 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commoncontrols.h
DLL	Comctl32.dll (versione 6.0 o successiva)

Condividi tramite