ImageList_AddIcon macro (commctrl.h)

Ajoute une icône ou un curseur à une liste d’images. ImageList_AddIcon appelle la fonction ImageList_ReplaceIcon .

Syntaxe

int ImageList_AddIcon(
   HIMAGELIST himl,
   HICON      hicon
);

Paramètres

himl

Type : HIMAGELIST

Handle de la liste d’images. Si ce paramètre identifie une liste d’images masquées, la macro copie l’image et les bitmaps de masque de l’icône ou du curseur. Si ce paramètre identifie une liste d’images non masquées, la macro copie uniquement l’image bitmap.

hicon

Type : HICON

Handle de l’icône ou du curseur qui contient la 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 macro 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 quand elle n’est plus nécessaire.

La macro ImageList_AddIcon est définie comme suit :

#define  ImageList_AddIcon(himl, hicon) ImageList_ReplaceIcon(himl, -1, hicon)

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