Partager via

macro TreeView_GetNextItem (commctrl.h)

  • Article

Récupère l’élément d’arborescence qui porte la relation spécifiée avec un élément spécifié. Vous pouvez utiliser cette macro, utiliser l’une des macros TreeView_Get décrites ci-dessous ou envoyer le message TVM_GETNEXTITEM explicitement.

Syntaxe

void TreeView_GetNextItem(
   hwnd,
   hitem,
   code
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle arborescence.

hitem

Type : HTREEITEM

Gérez un élément.

code

Type : UINT

Indicateur spécifiant l’élément à récupérer. Ce paramètre peut être l’une des valeurs suivantes :

Valeur Signification
TVGN_CARET
 Récupère l’élément actuellement sélectionné. Vous pouvez utiliser la macro TreeView_GetSelection pour envoyer ce message.
TVGN_CHILD
 Récupère le premier élément enfant de l’élément spécifié par le paramètre hitem . Vous pouvez utiliser la macro TreeView_GetChild pour envoyer ce message.
TVGN_DROPHILITE
 Récupère l’élément qui est la cible d’une opération de glisser-déplacer. Vous pouvez utiliser la macro TreeView_GetDropHilight pour envoyer ce message.
TVGN_FIRSTVISIBLE
 Récupère le premier élément visible. Vous pouvez utiliser la macro TreeView_GetFirstVisible pour envoyer ce message.
TVGN_NEXT
 Récupère l’élément frère suivant. Vous pouvez utiliser la macro TreeView_GetNextSibling pour envoyer ce message.
TVGN_NEXTSELECTED
 Windows Vista et versions ultérieures. Récupère l'élément sélectionné suivant. Vous pouvez utiliser la macro TreeView_GetNextSelected pour envoyer ce message.
TVGN_NEXTVISIBLE
 Récupère l’élément visible suivant l’élément spécifié. L’élément spécifié doit être visible. Utilisez le message TVM_GETITEMRECT pour déterminer si un élément est visible. Vous pouvez utiliser la macro TreeView_GetNextVisible pour envoyer ce message.
TVGN_PARENT
 Récupère le parent de l’élément spécifié. Vous pouvez utiliser la macro TreeView_GetParent pour envoyer ce message.
TVGN_PREVIOUS
 Récupère l’élément frère précédent. Vous pouvez utiliser la macro TreeView_GetPrevSibling pour envoyer ce message.
TVGN_PREVIOUSVISIBLE
 Récupère le premier élément visible qui précède l’élément spécifié. L’élément spécifié doit être visible. Utilisez le message TVM_GETITEMRECT pour déterminer si un élément est visible. Vous pouvez utiliser la macro TreeView_GetPrevVisible pour envoyer ce message.
TVGN_ROOT
 Récupère l’élément le plus haut ou le premier élément du contrôle d’arborescence. Vous pouvez utiliser la macro TreeView_GetRoot pour envoyer ce message.

Valeur de retour

None

Remarques

Cette macro retourne la valeur NULL si l’élément récupéré est le nœud racine de l’arborescence. Par exemple, si vous utilisez cette macro avec l’indicateur TVGN_PARENT sur un enfant de premier niveau du nœud racine de l’arborescence, la macro retourne NULL.

Configuration requise

Condition requise Valeur
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