TVM_GETNEXTITEM消息

检索树视图项,该树视图项承载与指定项的指定关系。 可以使用 TreeView_GetNextItem 宏显式发送此消息。

参数

wParam

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

含义
TVGN_CARET
检索当前选定的项。 可以使用 TreeView_GetSelection 宏发送此消息。
TVGN_CHILD
检索 由 hitem 参数指定的项的第一个子项。 可以使用 TreeView_GetChild 宏发送此消息。
TVGN_DROPHILITE
检索作为拖放操作目标的项。 可以使用 TreeView_GetDropHilight 宏发送此消息。
TVGN_FIRSTVISIBLE
检索树视图窗口中可见的第一个项。 可以使用 TreeView_GetFirstVisible 宏发送此消息。
TVGN_LASTVISIBLE
版本 4.71。 检索树中最后的扩展项。 这不会检索树视图窗口中最后的可见项。 可以使用 TreeView_GetLastVisible 宏发送此消息。
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 宏发送此消息。

lParam

项的句柄。

返回值

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

备注

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

还可以使用以下相关宏之一:

TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

要求

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