macro TreeView_GetItem (commctrl.h)

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