ImageList_SetOverlayImage, fonction (commctrl.h)

Ajoute une image spécifiée à la liste des images à utiliser comme masques de superposition. Une liste d’images peut comporter jusqu’à quatre masques de superposition dans les versions 4.70 et antérieures et jusqu’à 15 dans la version 4.71. La fonction affecte un index de masque de superposition à l’image spécifiée.

Syntaxe

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

Paramètres

[in] himl

Type : HIMAGELIST

Handle de la liste d’images.

[in] iImage

Type : int

Index de base zéro d’une image dans la liste d’images himl . Cet index identifie l’image à utiliser comme masque de superposition.

[in] iOverlay

Type : int

Index de base un du masque de superposition.

Valeur retournée

Type : BOOL

Retourne une valeur différente de zéro en cas de réussite, ou zéro dans le cas contraire.

Remarques

Un masque de superposition est une image dessinée en toute transparence sur une autre image. Pour dessiner un masque de superposition sur une image, appelez la fonction ImageList_Draw ou ImageList_DrawEx . Le paramètre fStyle de ces fonctions peut utiliser la macro INDEXTOOVERLAYMASK pour spécifier un index de masque de superposition.

Un appel à cette méthode échoue et retourne E_INVALIDARG, sauf si la liste d’images est créée à l’aide d’un masque.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commctrl.h
Bibliothèque	Comctl32.lib
DLL	Comctl32.dll
Ensemble d’API	ext-ms-win-shell-comctl32-init-l1-1-1 (introduit dans Windows 10, version 10.0.14393)