Partager via


LVM_GETITEM message

Récupère tout ou partie des attributs d’un élément de liste. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro ListView_GetItem .

Paramètres

wParam

Doit être zéro.

lParam

Pointeur vers une structure LVITEM qui spécifie les informations à récupérer et reçoit des informations sur l’élément list-view.

Valeur retournée

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

Notes

Lorsque le message LVM_GETITEM est envoyé, les membres iItem et iSubItem identifient l’élément ou le sous-élément pour récupérer des informations sur et le membre du masque spécifie les attributs à récupérer. Pour obtenir la liste des valeurs possibles, consultez la description de la structure LVITEM .

Si l’indicateur LVIF_TEXT est défini dans le membre masque de la structure LVITEM , le membre pszText doit pointer vers une mémoire tampon valide et le membre cchTextMax doit être défini sur le nombre de caractères dans cette mémoire tampon. Les applications ne doivent pas supposer que le texte sera nécessairement placé dans la mémoire tampon spécifiée. Le contrôle peut à la place modifier le membre pszText de la structure pour qu’il pointe vers le nouveau texte, plutôt que de le placer dans la mémoire tampon.

Si le membre mask spécifie la valeur LVIF_STATE, le membre stateMask doit spécifier les bits d’état d’élément à récupérer. Lors de la sortie, le membre d’état contient les valeurs des bits d’état spécifiés.

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_GETITEMW (Unicode) et LVM_GETITEMA (ANSI)