TreeView_SelectSetFirstVisible 宏（commctrl.h）

垂直滚动树视图控件，以确保指定的项可见。如果可能，指定的项将成为控件窗口顶部的第一个可见项。可以使用此宏或 TreeView_Select 宏，也可以显式发送 TVM_SELECTITEM 消息。

语法

BOOL TreeView_SelectSetFirstVisible(
   HWND      hwnd,
   HTREEITEM hitem
);

hwnd

类型：HWND

树视图控件的句柄。

hitem

类型：HTREEITEM

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

类型：BOOL

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

树视图控件显示窗口内任意数量的项。如果指定的项靠近控件的项层次结构的底部，则它可能不会成为第一个可见项，具体取决于窗口中容纳的项数。

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

使用 TreeView_SelectSetFirstVisible 宏等效于发送 TVM_SELECTITEM 消息，其标志参数设置为TVGN_FIRSTVISIBLE值。