CTreeCtrl::Select

BOOL Select( HTREEITEM hItem, UINT nCode );

Return Value

Nonzero if successful; otherwise 0.

Parameters

hItem

Handle of a tree item.

nCode

The type of action to take. This parameter can be one of the following values:

• TVGN_CARET   Sets the selection to the given item.
  
  
• TVGN_DROPHILITE   Redraws the given item in the style used to indicate the target of a drag-and-drop operation.
  
  
• TVGN_FIRSTVISIBLE   Scrolls the tree view vertically so that the given item is the first visible item.

Remarks

Call this function to select the given tree view item, scroll the item into view, or redraw the item in the style used to indicate the target of a drag-and-drop operation.

If nCode contains the value TVGN_CARET, the parent window receives the TVN_SELCHANGING and TVN_SELCHANGED notification messages. In addition, 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.

CTreeCtrl Overview |  Class Members |  Hierarchy Chart

See Also   CTreeCtrl::SelectItem, CTreeCtrl::GetSelectedItem, CTreeCtrl::SelectDropTarget