TreeView_Select宏 (commctrl.h)

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

语法

void TreeView_Select(
   hwnd,
   hitem,
   code
);

参数

hwnd

类型: HWND

树视图控件的句柄。

hitem

类型: HTREEITEM

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

code

类型: UINT

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

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

返回值

备注

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

要求

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