TVM_SELECTITEM消息

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

参数

wParam

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

值	含义
TVGN_CARET	将所选内容设置为指定项。 树视图控件的父窗口接收 TVN_SELCHANGING 和 TVN_SELCHANGED 通知代码。
TVGN_DROPHILITE	在用于指示拖放操作目标的样式中重绘指定项。
TVGN_FIRSTVISIBLE	确保指定的项可见，并尽可能将其显示在控件窗口的顶部。 树视图控件显示窗口中容纳的任意数量的项。 如果指定的项靠近控件的项层次结构的底部，则它可能不会成为第一个可见项，具体取决于窗口中容纳的项目数。
TVSI_NOSINGLEEXPAND	选择单个项时，确保树视图不会展开该项的子项。 仅当与 TVGN_CARET 标志一起使用时，这才有效。 注意： 若要使用此标志，必须提供指定 Comclt32.dll 版本 6.0 的清单。 有关清单的详细信息，请参阅 启用视觉样式。

lParam

项的句柄。 如果 lParam 为 NULL，则控件设置为没有选定项。

返回值

如果成功，则返回 TRUE ，否则返回 FALSE 。

备注

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

使用 TreeView_SelectItem 宏等效于发送将 wParam 设置为 TVGN_CARET 值的TVM_SELECTITEM消息。 使用 TreeView_SelectDropTarget 宏等效于发送 wParam 设置为TVGN_DROPHILITE值的TVM_SELECTITEM消息。 使用 TreeView_SelectSetFirstVisible等效于发送 wParam 设置为TVGN_FIRSTVISIBLE值的TVM_SELECTITEM消息。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	Commctrl.h