TVM_SELECTITEM

  • Article

This message 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 send this message explicitly or by using the TreeView_Select, TreeView_SelectItem, or TreeView_SelectDropTarget macro.

TVM_SELECTITEM wParam = (WPARAM) flag; 
lParam = (LPARAM)(HTREEITEM) hitem;

Parameters

  • flag
    Action flag. It is one of the following values:

    Value Description
    TVGN_CARET Sets the selection to the specified item. The tree view control's parent window receives the TVN_SELCHANGING and TVN_SELCHANGED notification messages.
    TVGN_DROPHILITE Redraws the specified 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.

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

Return Values

TRUE indicates success. FALSE indicates failure.

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 control's parent window receives the TVN_ITEMEXPANDING and TVN_ITEMEXPANDED notification messages.

Related macro: TreeView_Select

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

TVN_ITEMEXPANDED, TVN_ITEMEXPANDING, TVN_SELCHANGED, TVN_SELCHANGING

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.