macro ListView_GetItem (commctrl.h)

Obtient tout ou partie des attributs d’un élément de vue de liste. Vous pouvez utiliser cette macro ou envoyer le message LVM_GETITEM explicitement.

Syntaxe

void ListView_GetItem(
   hwnd,
   pitem
);

Paramètres

hwnd

Type : HWND

Handle du contrôle list-view.

pitem

Type : LPLVITEM

Pointeur vers une structure LVITEM qui spécifie les informations à récupérer et reçoit des informations sur l’élément d’affichage de liste.

Valeur de retour

Aucune

Remarques

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.

Configuration requise

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commctrl.h