TreeView_SelectSetFirstVisible宏 (commctrl.h)

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

语法

void TreeView_SelectSetFirstVisible(
   hwnd,
   hitem
);

hwnd

类型： HWND

树视图控件的句柄。

hitem

类型： HTREEITEM

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

无

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

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

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