Partilhar via


TVN_BEGINLABELEDIT código de notificação

Notifica a janela pai de um controle de exibição de árvore 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 WM_NOTIFY .

TVN_BEGINLABELEDIT 

    ptvdi = (LPNMTVDISPINFO) lParam 

Parâmetros

lParam

Ponteiro para uma estrutura NMTVDISPINFO . O membro do item é uma estrutura TVITEM que contém informações válidas sobre o item que está sendo editado nos membros hItem, state, lParam e pszText .

Valor retornado

Retorna TRUE para cancelar a edição de rótulo.

Comentários

Quando a edição de rótulo começa, um controle de edição é criado, mas não posicionado ou exibido. Antes de ser exibido, o controle de exibição de árvore envia à janela pai um código de notificação TVN_BEGINLABELEDIT.

Para personalizar a edição de rótulos, implemente um manipulador para TVN_BEGINLABELEDIT e faça com que ele envie uma mensagem TVM_GETEDITCONTROL para o controle de exibição de árvore. 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 TVN_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
TVN_BEGINLABELEDITW (Unicode) e TVN_BEGINLABELEDITA (ANSI)