TreeView_GetNextItem 宏 (commctrl.h)

检索树视图项,该树视图项承载与指定项的指定关系。 可以使用此宏,使用下面所述的 TreeView_Get 宏之一,或显式发送 TVM_GETNEXTITEM 消息。

语法

void TreeView_GetNextItem(
   hwnd,
   hitem,
   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 宏发送此消息。

返回值

备注

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

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commctrl.h