Compartilhar via


LVN_BEGINLABELEDIT código de notificação

Notifica a janela pai de um controle de exibição de lista sobre o início da edição de rótulo para um item. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY .

LVN_BEGINLABELEDIT

    pdi = (LPNMLVDISPINFO) lParam; 

Parâmetros

lParam

Ponteiro para uma estrutura NMLVDISPINFO . O membro do item dessa estrutura é uma estrutura LVITEM cujo membro iItem identifica o item que está sendo editado. Observe que os subitems não podem ser editados; o membro iSubItem é sempre definido como zero.

Valor retornado

Para permitir que o usuário edite o rótulo, retorne FALSE.

Para impedir que o usuário edite o rótulo, retorne TRUE.

Comentários

Quando a edição de rótulo começa, um controle de edição é criado, posicionado e inicializado. Antes de ser exibido, o controle de exibição de lista envia à janela pai um código de notificação LVN_BEGINLABELEDIT.

Para personalizar a edição de rótulos, implemente um manipulador para LVN_BEGINLABELEDIT e faça com que ele envie uma mensagem LVM_GETEDITCONTROL para o controle de exibição de lista. Se um rótulo estiver sendo editado, o valor retornado será um identificador para o controle de edição. Use esse identificador para personalizar o controle de edição enviando as mensagens de EM_XXX usuais.

Quando o usuário cancela ou conclui a edição, a janela pai recebe um código de notificação LVN_ENDLABELEDIT .

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Commctrl.h
Nomes Unicode e ANSI
LVN_BEGINLABELEDITW (Unicode) e ANSI (LVN_BEGINLABELEDITA )