fonction ImageList_Add (commctrl.h)

Article
02/24/2024

Ajoute une ou plusieurs images à une liste d’images.

Syntaxe

int ImageList_Add(
  [in]           HIMAGELIST himl,
  [in]           HBITMAP    hbmImage,
  [in, optional] HBITMAP    hbmMask
);

Paramètres

[in] himl

Type : HIMAGELIST

Handle de la liste d’images.

[in] hbmImage

Type : HBITMAP

Handle de la bitmap qui contient l’image ou les images. Le nombre d’images est déduit de la largeur de la bitmap.

[in, optional] hbmMask

Type : HBITMAP

Handle de la bitmap qui contient le masque. Si aucun masque n’est utilisé avec la liste d’images, ce paramètre est ignoré. Ce paramètre peut être NULL.

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_Add copie l’image bitmap dans une structure de données interne. Veillez à utiliser la fonction DeleteObject pour supprimer hbmImage et hbmMask après le retour de la fonction.

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

Partager via