TreeView_EditLabel macro (commctrl.h)

Artigo
10/24/2024

Inicia a edição in-loco do texto do item especificado, substituindo o texto do item por um controle de edição de linha única que contém o texto. Essa macro seleciona implicitamente e concentra o item especificado. Você pode usar essa macro ou enviar a mensagem TVM_EDITLABEL explicitamente.

Sintaxe

HWND TreeView_EditLabel(
   HWND      hwnd,
   HTREEITEM hitem
);

Parâmetros

hwnd

Tipo: HWND

Manipule para o controle de exibição de árvore.

hitem

Tipo: HTREEITEM

Manipule para o item a ser editado.

Valor de retorno

Tipo: HWND

Retorna o identificador para o controle de edição usado para editar o texto do item se tiver êxito ou NULL caso contrário.

Observações

Essa macro envia um código de notificação TVN_BEGINLABELEDIT para o pai do controle de exibição de árvore.

Quando o usuário conclui ou cancela a edição, o controle de edição é destruído e o identificador não é mais válido. Você pode subclasse o controle de edição, mas não o destrua.

O controle deve ter o foco antes de chamar essa macro. O foco pode ser definido usando a função SetFocus.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via