Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This macro selects the specified tree-view item. You can use this macro or the TreeView_Selectmacro, or you can send the TVM_SELECTITEMmessage explicitly.

Syntax 

BOOL TreeView_SelectItem( 

hwnd, 

hitem 
);

Parameters

hwnd

Handle to the tree view control.

hitem

Handle to an item. If the hitemparameter is NULL, the control is set to have no selected item.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

When you call the TreeView_SelectItemmacro, the parent window of the control receives the TVN_SELCHANGINGand TVN_SELCHANGEDmessages. Also, if the specified item is the child of a collapsed parent item, the of child items for the parent item is expanded to reveal the specified item. In this case, the parent window receives the TVN_ITEMEXPANDINGand TVN_ITEMEXPANDEDmessages.

Using the TreeView_SelectItemmacro is equivalent to sending the TVM_SELECTITEM message with its flagparameter set to the TVGN_CARET value.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also