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

Article
08/22/2023

Remplace une image par une icône ou un curseur.

Syntaxe

HRESULT ReplaceIcon(
  [in]  int   i,
  [in]  HICON hicon,
  [out] int   *pi
);

Paramètres

[in] i

Type : int

Valeur de type int qui contient l’index de l’image à remplacer. Si i a la valeur -1, la fonction ajoute l’image à la fin de la liste.

[in] hicon

Type : HICON

Handle de l’icône ou du curseur qui contient la bitmap et le masque de la nouvelle image.

[out] pi

Type : int*

Pointeur vers un int qui contiendra l’index de l’image au retour 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

Étant donné que le système n’enregistre pas hicon, vous pouvez le détruire une fois que la fonction retourne si l’icône ou le curseur a été créé par CreateIcon. Vous n’avez pas besoin de détruire hicon s’il a été chargé par la fonction LoadIcon ; le système libère automatiquement une ressource d’icône quand elle n’est plus nécessaire.

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