TreeView_SelectSetFirstVisible info  Overview  Group

The TreeView_SelectSetFirstVisible macro scrolls the tree-view control vertically to ensure that the specified item is visible. If possible, the specified item becomes the first visible item at the top of the control’s window. You can use this macro, the TreeView_Select macro, or explicitly send the TVM_SELECTITEM message.

BOOL TreeView_SelectSetFirstVisible(

hwnd,
hitem
);

Parameters

hwnd 

Handle to the tree-view control.

hitem

Handle to an item. If the hitem parameter is NULL, the selection is removed from the currently selected item, if any.

Return Values

Returns TRUE if successful or FALSE otherwise.

Remarks

Tree-view controls display as many items as will fit in the window. If the specified item is near the bottom of the control’s hierarchy of items, it might not become the first visible item, depending on how many items fit in the window.

If the specified item is the child of a collapsed parent item, the parent’s list of child items is expanded to reveal the specified item. In this case, the parent window receives the TVN_ITEMEXPANDING and TVN_ITEMEXPANDED notification messages.

Using the TreeView_SelectSetFirstVisible macro is equivalent to sending the TVM_SELECTITEM message with its flag parameter set to the TVGN_FIRSTVISIBLE value.

See Also

TreeView_Select, TVM_SELECTITEM, TVN_ITEMEXPANDED, TVN_ITEMEXPANDING