macro ListView_SetImageList (commctrl.h)

Article
10/24/2024

Affecte une liste d’images à un contrôle d’affichage de liste. Vous pouvez utiliser cette macro ou envoyer explicitement le message LVM_SETIMAGELIST.

Syntaxe

HIMAGELIST ListView_SetImageList(
   HWND       hwnd,
   HIMAGELIST himl,
   int        iImageList
);

Paramètres

hwnd

Type : HWND

Handle du contrôle list-view.

himl

Type : HIMAGELIST

Handle de la liste d’images à affecter.

iImageList

Type : int

Type de liste d’images. Ce paramètre peut être l’une des valeurs suivantes :

Valeur	Signification
LVSIL_NORMAL	Liste d’images avec des icônes volumineuses.
LVSIL_SMALL	Liste d’images avec de petites icônes.
LVSIL_STATE	Liste d’images avec des images d’état.
LVSIL_GROUPHEADER	Liste d’images pour l’en-tête de groupe.

Valeur de retour

Type : HIMAGELIST

Retourne le handle à la liste d’images précédemment associée au contrôle si elle réussit, ou null sinon.

Remarques

La liste d’images actuelle est détruite lorsque le contrôle d’affichage de liste est détruit, sauf si le style LVS_SHAREIMAGELISTS est défini. Si vous utilisez ce message pour remplacer une liste d’images par une autre, votre application doit détruire explicitement toutes les listes d’images autres que celles actuelles.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h

Partager via