This message begins in-place editing of the specified items text, replacing the text of the item with a single-line edit control containing the text. This message implicitly selects and focuses the specified item. You can send this message explicitly or by using the TreeView_EditLabel macro.

TVM_EDITLABEL wParam = 0; 
lParam = (LPARAM)(HTREEITEM) hitem;


  • hitem
    Handle to the item to edit.

Return Values

The handle to the edit control used to edit the item text indicates success. NULL indicates otherwise.


This message sends a TVN_BEGINLABELEDIT notification message to the parent of the tree view control.

When the user completes or cancels editing, the edit control is destroyed and the handle is no longer valid. You can safely subclass the edit control, but do not destroy it.

Related macro: TreeView_EditLabel


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


 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.