macro TreeView_GetNextItem (commctrl.h)

Article
10/24/2024

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

Partager via