TreeView_Select宏 (commctrl.h)

选择指定的树视图项、将项滚动到视图中,或重新绘制用于指示拖放操作目标的样式中的项。 可以使用此宏或 TreeView_SelectItemTreeView_SelectSetFirstVisibleTreeView_SelectDropTarget 宏,也可以显式发送 TVM_SELECTITEM 消息。

语法

BOOL TreeView_Select(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

参数

hwnd

类型:HWND

树视图控件的句柄。

hitem

类型:HTREEITEM

项的句柄。 如果 hitem 参数 NULL,则将控件设置为没有选定的项。

code

类型:UINT

操作标志。 此参数可以是以下值之一:

价值 意义
TVGN_CARET
将所选内容设置为给定的项。 控件的父窗口接收 TVN_SELCHANGINGTVN_SELCHANGED 通知代码。
TVGN_DROPHILITE
重绘用于指示拖放操作目标的样式中的给定项。
TVGN_FIRSTVISIBLE
确保指定的项可见,并尽可能将其显示在控件窗口顶部。 树视图控件显示窗口内任意数量的项。 如果指定的项靠近控件的项层次结构的底部,则它可能不会成为第一个可见项,具体取决于窗口中容纳的项数。

返回值

类型:BOOL

如果成功,则返回 TRUE;否则返回 FALSE

言论

如果指定的项是折叠父项的子项,则展开父项的子项列表以显示指定的项。 在这种情况下,父窗口接收 TVN_ITEMEXPANDINGTVN_ITEMEXPANDED 通知代码。

要求

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