windows_programming_notes.nbk: Home | Index | Next Page: MAKEINTRESOURCE | Previous Page: LVM_GETEDITCONTROL

 LVN_BEGINLABELEDIT

Notifies a list-view control's parent window about the start of label editing for an item. This notification message is sent in the form of a WM_NOTIFY message.

    LVN_BEGINLABELEDIT 
        pdi = (LPNMLVDISPINFO) lParam; 

Parameters

pdi Address of an NMLVDISPINFO structure. The item member of this structure is an LVITEM structure whose iItem member identifies the item being edited.

Return Values

To allow the user to edit the label, return FALSE.

To prevent the user from editing the label, return TRUE.

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 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 cancels or completes the editing, the parent window receives an [LVN_ENDLABELEDIT] notification message.

windows_programming_notes.nbk: Home | Index | Next Page: MAKEINTRESOURCE | Previous Page: LVM_GETEDITCONTROL

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