Funzione ImageList_SetOverlayImage (commctrl.h)

Aggiunge un'immagine specificata all'elenco di immagini da usare come maschere di sovrapposizione. Un elenco di immagini può avere fino a quattro maschere di sovrapposizione nella versione 4.70 e precedenti e fino a 15 nella versione 4.71. La funzione assegna un indice della maschera di sovrimpressione all'immagine specificata.

Sintassi

BOOL ImageList_SetOverlayImage(
  [in] HIMAGELIST himl,
  [in] int        iImage,
  [in] int        iOverlay
);

Parametri

[in] himl

Tipo: HIMAGELIST

Handle per l'elenco di immagini.

[in] iImage

Tipo: int

Indice in base zero di un'immagine nell'elenco di immagini himl . Questo indice identifica l'immagine da usare come maschera di sovrapposizione.

[in] iOverlay

Tipo: int

Indice in base uno della maschera di sovrapposizione.

Valore restituito

Tipo: BOOL

Restituisce un valore diverso da zero se l'operazione ha esito positivo o zero in caso contrario.

Commenti

Una maschera di sovrapposizione è un'immagine disegnata in modo trasparente su un'altra immagine. Per disegnare una maschera di sovrimpressione su un'immagine, chiamare la funzione ImageList_Draw o ImageList_DrawEx . Il parametro fStyle di queste funzioni può usare la macro INDEXTOOVERLAYMASK per specificare un indice della maschera di sovrapposizione.

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

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 (introdotto in Windows 10 versione 10.0.14393)