Help Center
/
Help Center›AfxNova›CTreeView Class

CTreeView.SelectSetFirstVisiblemethod

Scrolls the treeview control vertically to ensure that the specified item is visible.

WindowsmethodCTreeView.incdocumented

Syntax

FUNCTION SelectSetFirstVisible (BYVAL hTreeView AS HWND, BYVAL hitem AS HTREEITEM) AS BOOLEAN

Parameters

NameDescription
hTreeViewThe handle of the TreeView control.
hitemHandle to an item. If the hitem parameter is NULL, the control is set to have no selected item.

Return value

Returns TRUE if successful, or FALSE otherwise.

Description

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.

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 codes.

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

Reference

  • Include file CTreeView.inc
  • Defined in AfxNova/CTreeView.inc:1095
  • Documented in Windows/WIndows Controls/CTreeView Class.md
  • Topic: CTreeView Class