ImageList_AddMasked, fonction (commctrl.h)

Article
08/22/2023

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

Syntaxe

int ImageList_AddMasked(
  HIMAGELIST himl,
  HBITMAP    hbmImage,
  COLORREF   crMask
);

Paramètres

himl

Type : HIMAGELIST

Handle de la liste d’images.

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.

crMask

Type : COLORREF

Couleur utilisée pour générer le masque. Chaque pixel de cette couleur dans la 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.

Valeur retournée

Type : int

Retourne l’index de la première nouvelle image en cas de réussite, ou -1 dans le cas contraire.

Remarques

La fonction ImageList_AddMasked copie la bitmap dans une structure de données interne. Les bitmaps dont la profondeur de couleur est supérieure à 8 bpp ne sont pas prises en charge. Veillez à utiliser la fonction DeleteObject pour supprimer hbmImage après le retour de la fonction.

Configuration requise


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)

Partager via