TreeView_GetNextItem 宏 (commctrl.h)
检索树视图项,该树视图项承载与指定项的指定关系。 可以使用此宏,使用下面所述的 TreeView_Get 宏之一,或显式发送 TVM_GETNEXTITEM 消息。
语法
void TreeView_GetNextItem(
hwnd,
hitem,
code
);
参数
hwnd
类型: HWND
树视图控件的句柄。
hitem
类型: HTREEITEM
项的句柄。
code
类型: UINT
指定要检索的项的标志。 此参数可能是以下值之一:
值 | 含义 |
---|---|
|
检索当前选定的项。 可以使用 TreeView_GetSelection 宏发送此消息。 |
|
检索 由 hitem 参数指定的项的第一个子项。 可以使用 TreeView_GetChild 宏发送此消息。 |
|
检索作为拖放操作目标的项。 可以使用 TreeView_GetDropHilight 宏发送此消息。 |
|
检索第一个可见项。 可以使用 TreeView_GetFirstVisible 宏发送此消息。 |
|
检索下一个同级项。 可以使用 TreeView_GetNextSibling 宏发送此消息。 |
|
Windows Vista 及更高版本。 检索下一个选定项。 可以使用 TreeView_GetNextSelected 宏发送此消息。 |
|
检索指定项之后的下一个可见项。 指定的项必须可见。 使用 TVM_GETITEMRECT 消息确定项是否可见。 可以使用 TreeView_GetNextVisible 宏发送此消息。 |
|
检索指定项的父级。 可以使用 TreeView_GetParent 宏发送此消息。 |
|
检索前一个同级项。 可以使用 TreeView_GetPrevSibling 宏发送此消息。 |
|
检索指定项之前的第一个可见项。 指定的项必须可见。 使用 TVM_GETITEMRECT 消息确定项是否可见。 可以使用 TreeView_GetPrevVisible 宏发送此消息。 |
|
检索树视图控件的最顶层或最上面的第一项。 可以使用 TreeView_GetRoot 宏发送此消息。 |
返回值
无
备注
如果要检索的项是树的根节点,则此宏将返回 NULL 。 例如,如果在树视图根节点的第一级子级上将此宏与TVGN_PARENT标志一起使用,则该宏将返回 NULL。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | commctrl.h |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈