macro ListView_GetItem (commctrl.h)

Article
10/24/2024

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

Syntaxe

BOOL ListView_GetItem(
   HWND     hwnd,
   LPLVITEM 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 recevoir des informations sur l’élément d’affichage de liste.

Valeur de retour

Type : BOOL

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

Remarques

Lorsque le message LVM_GETITEM est envoyé, l'iItem et membres iSubItem identifient l’élément ou le sous-élément pour récupérer des informations sur et le masque masque membre 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 masque membre 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 de 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 pszText membre de la structure pour pointer vers le nouveau texte plutôt que de le placer dans la mémoire tampon.

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

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

Partager via