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
Um identificador para o controle de exibição de lista.
Valor de retorno
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 |