Compartilhar via


ListView_GetEditControl macro (commctrl.h)

Obtém o identificador para o controle de edição que está sendo usado para editar o texto de um item de exibição de lista. Você pode usar essa macro ou enviar a mensagem LVM_GETEDITCONTROL explicitamente.

Sintaxe

HWND ListView_GetEditControl(
   HWND hwndLV
);

Parâmetros

hwndLV

Tipo: HWND

Um identificador para o controle de exibição de lista.

Valor de retorno

Tipo: HWND

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

Observações

Quando a edição de rótulos 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 use-o ListView_GetEditControl para enviar 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 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 deve destruí-lo. Para cancelar a edição, você pode enviar ao controle de exibição de lista uma mensagem WM_CANCELMODE.

O item de exibição de lista que está sendo editado é o item focado no momento, ou seja, o item no estado focalizado. Para localizar um item com base em seu estado, use a mensagem LVM_GETNEXTITEM.

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

Consulte também

LVM_GETEDITCONTROL