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

Remplace une image dans une liste d’images par une nouvelle image.

Syntaxe

HRESULT Replace(
  [in]           int     i,
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask
);

Paramètres

[in] i

Type : int

Valeur de type int qui contient l’index de l’image à remplacer.

[in] hbmImage

Type : HBITMAP

Handle de la bitmap qui contient l’image.

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

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 ::Replace copie la bitmap dans une structure de données interne. Vous devez utiliser DeleteObject pour supprimer hbmImage et hbmMask après le retour de la méthode.

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