Compartilhar via


Edição de rótulo de controle de árvore

O usuário pode editar diretamente os rótulos de itens em um controle de árvore (CTreeCtrl) que tem o TVS_EDITLABELS estilo.O usuário começa edição clicando no rótulo do item que tem o foco.Um aplicativo inicia edição usando o EditLabel função de membro.O controle de árvore envia a notificação ao editar começa e quando é cancelada ou concluída.Quando edição estiver concluída, você é responsável por atualizar o rótulo do item, se apropriado.

Quando o rótulo edição começa, um controle de árvore envia uma TVN_BEGINLABELEDIT mensagem de notificação.Processando essa notificação, você pode permitir a edição de algumas etiquetas e impedir a edição de outros.Retornando 0 permite a edição e retornar diferente de zero impede que ele.

Quando a edição de rótulo é cancelada ou concluída, um controle de árvore envia uma TVN_ENDLABELEDIT mensagem de notificação.O lParam parâmetro é o endereço de um NMTVDISPINFO estrutura.O item membro é um TVITEM estrutura que identifica o item e inclui o texto editado.Você é responsável por atualizar o rótulo do item, se apropriado, talvez após validar a cadeia de caracteres editada.O pszText membro do TV_ITEM é 0 se a edição é cancelada.

Durante a edição rótulo, geralmente em resposta ao TVN_BEGINLABELEDIT mensagem de notificação, você pode obter um ponteiro para o controle de edição usado para rótulo edição usando o GetEditControl função de membro.Você pode chamar o controle de edição SetLimitText função de membro para limitar a quantidade de texto que um usuário pode inserir ou subclasse o controle de edição para interceptar e descartar caracteres inválidos.Observe, Entretanto, o controle de edição é exibido somente depois deTVN_BEGINLABELEDIT é enviada.

Consulte também

Referência

Usando CTreeCtrl

Conceitos

Controles (MFC)