TreeView_GetNextItem 宏（commctrl.h）

检索具有指定关系到指定项的树视图项。可以使用此宏、使用以下 TreeView_Get 宏之一，或显式发送 TVM_GETNEXTITEM 消息。

语法

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

hwnd

类型：HWND

树视图控件的句柄。

hitem

类型：HTREEITEM

项的句柄。

code

类型：UINT

指定要检索的项的标志。此参数可以是以下值之一：

价值	意义
TVGN_CARET	检索当前选定的项。可以使用 TreeView_GetSelection 宏发送此消息。
TVGN_CHILD	检索由 hitem 参数指定的项的第一个子项。可以使用 TreeView_GetChild 宏发送此消息。
TVGN_DROPHILITE	检索作为拖放操作目标的项。可以使用 TreeView_GetDropHilight 宏发送此消息。
TVGN_FIRSTVISIBLE	检索第一个可见项。可以使用 TreeView_GetFirstVisible 宏发送此消息。
TVGN_NEXT	检索下一个同级项。可以使用 TreeView_GetNextSibling 宏发送此消息。
TVGN_NEXTSELECTED	Windows Vista 及更高版本。检索下一个选定项。可以使用 TreeView_GetNextSelected 宏发送此消息。
TVGN_NEXTVISIBLE	检索指定项后面的下一个可见项。指定的项必须可见。使用 TVM_GETITEMRECT 消息来确定项是否可见。可以使用 TreeView_GetNextVisible 宏发送此消息。
TVGN_PARENT	检索指定项的父项。可以使用 TreeView_GetParent 宏发送此消息。
TVGN_PREVIOUS	检索上一个同级项。可以使用 TreeView_GetPrevSibling 宏发送此消息。
TVGN_PREVIOUSVISIBLE	检索位于指定项前面的第一个可见项。指定的项必须可见。使用 TVM_GETITEMRECT 消息来确定项是否可见。可以使用 TreeView_GetPrevVisible 宏发送此消息。
TVGN_ROOT	检索树视图控件的最顶层或第一项。可以使用 TreeView_GetRoot 宏发送此消息。

类型：HTREEITEM

如果成功，则返回项的句柄。在大多数情况下，该消息返回一个 NULL 值来指示错误。有关详细信息，请参阅“备注”部分。

如果检索的项是树的根节点，则此宏将返回 NULL。例如，如果将此宏与树视图根节点的第一级子级的TVGN_PARENT标志一起使用，则宏将返回 NULL。