windows_programming_notes.nbk: Home | Index | Next Page: ListView_GetItem | Previous Page: Listview control notifications

 ListView_GetEditControl

Retrieves the handle to the edit control being used to edit a list-view item's text. You can use this macro or send the LVM_GETEDITCONTROL message explicitly.

    HWND ListView_GetEditControl(
        HWND hwnd
    );

Parameters

hwnd

Handle to the list-view control.

Return Values

Returns the handle to the edit control if successful, or NULL otherwise.

Remarks

When label editing begins, an edit control is created, positioned, and initialized. Before it is displayed, the list-view control sends its parent window an LVN_BEGINLABELEDIT notification message.

To customize label editing, implement a handler for LVN_BEGINLABELEDIT and have it use ListView_GetEditControl to send an LVM_GETEDITCONTROL message to the list-view control. If a label is being edited, the return value will be a handle to the edit control. Use this handle to customize the edit control by sending the usual EM_XXX messages.

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 you should not destroy it. To cancel editing, you can send the list-view control a WM_CANCELMODE message.

The list-view item being edited is the currently focused item—that is, the item in the focused state. To find an item based on its state, use the LVM_GETNEXTITEM message.

See Also

LVM_GETEDITCONTROL

windows_programming_notes.nbk: Home | Index | Next Page: ListView_GetItem | Previous Page: Listview control notifications

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time