IImageList ::SetOverlayImage, méthode (commoncontrols.h)

Article
02/26/2024

Ajoute une image spécifiée à la liste des images utilisées comme masques de superposition. Une liste d’images peut avoir jusqu’à quatre masques de superposition dans Common Controls version 4.70 et antérieure, et jusqu’à 15 dans la version 4.71 ou ultérieure. La méthode affecte un index de masque de superposition à l’image spécifiée.

Syntaxe

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

Paramètres

[in] iImage

Type : int

Valeur de type int qui contient l’index de base zéro d’une image dans la liste d’images. Cet index identifie l’image à utiliser comme masque de superposition.

[in] iOverlay

Type : int

Valeur de type int qui contient l’index de base un du masque de superposition.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

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 IImageList ::D raw. 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.

Pour utiliser IImageList ::SetOverlayImage, spécifiez Comctl32.dll version 6 dans le manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

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	commoncontrols.h
DLL	Comctl32.dll (version 6.0 ou ultérieure)

Partager via