TreeView_SelectItem 3Q40X0

The TreeView_SelectItem 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_Select1IXHYS_ or TreeView_SelectDropTarget2SZG4I macro, or explicitly send the TVM_SELECTITEM7MYU9C message.

BOOL TreeView_SelectItem(

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

If the TVGN_CARET value is specified, the parent window receives the TVN_SELCHANGING4Q4FGW and TVN_SELCHANGEDLKSRZ6 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_ITEMEXPANDINGL92XTR and TVN_ITEMEXPANDED1AC8IWC notification messages.

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