LVM_SETITEM message

Définit tout ou partie des attributs d’un élément d’affichage de liste. 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 mask spécifie les attributs à définir. Si le membre mask 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 mask 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 en cas de réussite, ou FALSE dans le cas contraire.

Notes

Pour définir les attributs d’un élément list-view, 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 les membres state, pszText, iImage et 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, puis 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 les membres state ou lParam pour les sous-éléments, car les sous-éléments n’ont pas ces attributs. Dans les versions 4.70 et ultérieures, vous pouvez définir le membre iImage pour les sous-éléments. L’image de 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 du sous-élément.

Spécifications

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)