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

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

Syntaxe

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

Paramètres

[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é.

[out] pi

Type : int*

Lorsque cette méthode est retournée, contient un pointeur vers l’index de la première nouvelle image. Si la méthode ne parvient pas à ajouter la nouvelle image, cette valeur est -1.

Valeur retournée

Type : HRESULT

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

Remarques

IImageList ::Add copie la bitmap dans une structure de données interne. Vous devez utiliser la fonction DeleteObject pour supprimer hbmImage et hbmMask après le retour de la méthode.

Pour utiliser IImageList ::Add, 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 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commoncontrols.h
DLL	Comctl32.dll (version 6.0 ou ultérieure)