TreeView_Select

The TreeView_Select macro selects the specified tree-view item, scrolls the item into view, or redraws the item in the style used to indicate the target of a drag-and-drop operation. You can use this macro, the TreeView_SelectItem, TreeView_SelectSetFirstVisible, or TreeView_SelectDropTarget macros, or explicitly send the TVM_SELECTITEM message.

BOOL TreeView_Select(

hwnd,
hitem,
flag
);

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.

flag

Action flag. This parameter can be one of the following values:

Value	Meaning
TVGN_CARET	Sets the selection to the given item. The control’s parent window receives the TVN_SELCHANGING and TVN_SELCHANGED notification messages.
TVGN_DROPHILITE	Redraws the given item in the style used to indicate the target of a drag and drop operation.
TVGN_FIRSTVISIBLE	Ensures that the specified item is visible, and if possible, displays it at the top of the control’s window. 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.

Return Values

Returns TRUE if successful or FALSE otherwise.

Remarks

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.

See Also

TreeView_SelectDropTarget, TreeView_SelectItem, TreeView_SelectSetFirstVisible, TVM_SELECTITEM, TVN_ITEMEXPANDED, TVN_ITEMEXPANDING, TVN_SELCHANGED, TVN_SELCHANGING 

© 1997 Microsoft Corporation. All rights reserved. Legal Notices.