ImageList_ReplaceIcon, fonction (commctrl.h)

Article
02/26/2024

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

Syntaxe

int ImageList_ReplaceIcon(
  [in] HIMAGELIST himl,
  [in] int        i,
  [in] HICON      hicon
);

Paramètres

[in] himl

Type : HIMAGELIST

Handle de la liste d’images.

[in] i

Type : int

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

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

Valeur retournée

Type : int

Retourne l’index de l’image en cas de réussite, ou -1 dans le cas contraire.

Remarques

Étant donné que le système n’enregistre pas hicon, vous pouvez le détruire une fois la fonction retournée si l’icône ou le curseur a été créé par la fonction 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 lorsqu’elle n’est plus nécessaire.

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
Ensemble d’API	ext-ms-win-shell-comctl32-init-l1-1-1 (introduit dans Windows 10, version 10.0.14393)

Partager via