macro TreeView_GetItem (commctrl.h)

Article
10/24/2024

Récupère un ou plusieurs attributs d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETITEM.

Syntaxe

BOOL TreeView_GetItem(
   HWND     hwnd,
   LPTVITEM pitem
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle d’arborescence.

pitem

Type : LPTVITEM

Pointeur vers une structure TVITEM qui spécifie les informations à récupérer et recevoir des informations sur l’élément. Avec version 4.71 et ultérieures, vous pouvez utiliser une structure TVITEMEX à la place.

Valeur de retour

Type : BOOL

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

Remarques

Lorsque le message TVM_GETITEM est envoyé, le hItem membre du TVITEM ou structure TVITEMEX identifie l’élément à propos duquel récupérer des informations et le masque membre spécifie les attributs à récupérer.

Si l’indicateur de TVIF_TEXT est défini dans le masque de membre du TVITEM ou structure TVITEMEX, 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. Le texte retourné ne sera pas nécessairement stocké dans la mémoire tampon d’origine passée par l’application. Il est possible que pszText pointe vers du texte dans une nouvelle mémoire tampon plutôt que de le placer dans l’ancienne mémoire tampon.

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