macro ListView_SetItem (commctrl.h)

Définit certains attributs ou tous les attributs d’un élément d’affichage de liste. Vous pouvez également utiliser ListView_SetItem pour définir le texte d’un sous-élément. Vous pouvez utiliser cette macro ou envoyer explicitement le message LVM_SETITEM.

Syntaxe

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

Paramètres

hwnd

Type : HWND

Handle du contrôle list-view.

pitem

Type : const LPLVITEM

Pointeur vers une structure LVITEM qui contient les nouveaux attributs d’élément. Les membres iItem et iSubItem identifient l’élément ou le sous-élément, et le masque masque membre spécifie les attributs à définir. Si le masque membre spécifie la valeur LVIF_TEXT, le membre pszText est l’adresse d’une chaîne terminée par null et le membre cchTextMax est ignoré. Si le masque de membre spécifie la valeur LVIF_STATE, le membre stateMask spécifie les états d’élément à modifier et l’état membre contient les valeurs de ces états.

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Remarques

Pour définir les attributs d’un élément d’affichage de liste, définissez le membre iItem de la structure LVITEM sur l’index de l’élément, puis définissez le membre iSubItem sur zéro. Pour un élément, vous pouvez utiliser led’état , pszText, iImageet membres lParam de la structure LVITEM pour modifier ces paramètres d’élément.

Pour définir le texte d’un sous-élément, définissez l' iItem et membres iSubItem pour indiquer le sous-élément spécifique, puis utilisez le pszText membre pour spécifier le texte. Vous pouvez également utiliser la macro ListView_SetItemText pour définir le texte d’un sous-élément. Vous ne pouvez pas définir l’état ou membres lParam pour les sous-éléments, car les sous-éléments n’ont pas ces attributs. Dans la version 4.70 et ultérieures, vous pouvez définir le membre iImage pour les sous-éléments. L’image sous-élément s’affiche si le contrôle d’affichage de liste a le style étendu LVS_EX_SUBITEMIMAGES. Les versions précédentes ignorent l’image sous-élément.

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