macro TreeView_GetItem (commctrl.h)

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

Syntaxe

void TreeView_GetItem(
   hwnd,
   pitem
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle arborescence.

pitem

Type : LPTVITEM

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

Valeur de retour

Aucune

Remarques

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

Si l’indicateur TVIF_TEXT est défini dans le membre masque de la structure TVITEM ou 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 dans cette mémoire tampon. Le texte retourné ne sera pas nécessairement stocké dans la mémoire tampon d’origine transmise 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.

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