ImageList_AddIcon macro (commctrl.h)
Ajoute une icône ou un curseur à une liste d’images. ImageList_AddIcon appelle la fonction ImageList_ReplaceIcon .
Syntaxe
void ImageList_AddIcon(
himl,
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 |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour