message LVM_SETITEM

Définit certains attributs ou tous les attributs d’un élément list-view. Vous pouvez également envoyer LVM_SETITEM pour définir le texte d’un sous-élément. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro ListView_SetItem .

Paramètres

wParam

Doit être zéro.

lParam

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 membre masque spécifie les attributs à définir. Si le membre de masque 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 membre de masque spécifie la valeur LVIF_STATE, le membre stateMask spécifie les états d’élément à modifier et le membre d’état contient les valeurs de ces états.

Valeur retournée

Retourne TRUE si elle réussit ou FALSE dans le cas contraire.

Notes

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 et définissez le membre iSubItem sur zéro. Pour un élément, vous pouvez définir l’état, pszText, iImage et les membres lParam de la structure LVITEM .

Pour définir le texte d’un sous-élément, définissez les membres iItem et iSubItem pour indiquer le sous-élément spécifique et utilisez le membre pszText 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 les membres lParam pour les sous-éléments, car les sous-éléments n’ont pas ces attributs. Dans la version 4.70 et ultérieure, 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.

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]
En-tête
Commctrl.h
Noms Unicode et ANSI
LVM_SETITEMW (Unicode) et LVM_SETITEMA (ANSI)