Méthode IImageList ::AddMasked (commoncontrols.h)

Article
02/26/2024

Ajoute une ou plusieurs images à une liste d’images, générant un masque à partir de l’image bitmap spécifiée.

Syntaxe

HRESULT AddMasked(
  [in]  HBITMAP  hbmImage,
  [in]  COLORREF crMask,
  [out] int      *pi
);

Paramètres

[in] hbmImage

Type : HBITMAP

Handle de la bitmap qui contient une ou plusieurs images. Le nombre d’images est déduit de la largeur de la bitmap.

[in] crMask

Type : COLORREF

Couleur utilisée pour générer le masque. Chaque pixel de cette couleur dans l’image bitmap spécifiée est remplacé par noir, et le bit correspondant dans le masque est défini sur 1. Si ce paramètre est CLR_DEFAULT, la couleur du pixel à (0,0) est utilisée comme masque.

[out] pi

Type : int*

Pointeur vers un int qui contient l’index de la première nouvelle image lorsqu’elle retourne, en cas de réussite, ou -1 dans le cas contraire.

Valeur retournée

Type : HRESULT

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

Remarques

Note La bitmap passée dans hbmImage sera modifiée.

IImageList ::AddMasked copie la bitmap dans une structure de données interne. Les bitmaps dont la profondeur de couleur est supérieure à 8bpp ne sont pas prises en charge. Vous devez utiliser la fonction DeleteObject pour supprimer hbmImage et crMask après le retour de la méthode.

Pour utiliser IImageList ::AddMasked, 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