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 or TreeView_SelectDropTarget macro, 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. |
| 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. |
Return Values
Returns TRUE if successful or FALSE otherwise.
Remarks
If the TVGN_CARET value is specified, the parent window receives the TVN_SELCHANGING and TVN_SELCHANGED notification messages. Also, 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