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。
还可以使用以下相关宏之一:
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
标头 |
|