ImageList_ReplaceIcon, fonction (commctrl.h)

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