Partager via


macro TreeView_GetNextItem (commctrl.h)

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

Syntaxe

HTREEITEM TreeView_GetNextItem(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle d’arborescence.

hitem

Type : HTREEITEM

Gérer 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 le premier ou le premier élément du contrôle d’arborescence. Vous pouvez utiliser la macro TreeView_GetRoot pour envoyer ce message.

Valeur de retour

Type : HTREEITEM

Retourne le handle à l’élément en cas de réussite. Dans la plupart des cas, le message retourne une valeur NULL pour indiquer une erreur. Pour plus d’informations, consultez la section Remarques.

Remarques

Cette macro retourne 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.

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