通过

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