Processamento de mensagens de exibição de lista padrão
Esta seção lista o processamento de mensagens de janela executado por um controle de exibição de lista.
Processamento de mensagem
A tabela a seguir descreve o processamento de mensagens de janela executado por um controle de exibição de lista.
| Mensagem | Processamento realizado |
|---|---|
| WM_CHAR | Procura um item de exibição de lista que começa com o caractere especificado e, se o item for encontrado, seleciona e define o foco para o item. Vários caracteres recebidos dentro de um intervalo de tempo limite, atualmente fixado em um segundo, são concatenados e o controle de exibição de lista procura um item que começa com a cadeia de caracteres resultante. |
| WM_COMMAND | Processa os códigos de notificação EN_UPDATE e EN_KILLFOCUS e encaminha todas as outras notificações de controle de edição para a janela pai. |
| WM_CREATE | Executa inicialização adicional ao WM_NCCREATE. Se o estilo de janela LVS_SHAREIMAGELISTS não for especificado, o controle list-view criará o ícone e as listas de imagens de ícones pequenos neste ponto. |
| WM_DESTROY | Libera recursos alocados durante WM_CREATE. |
| WM_ERASEBKGND | Apaga o plano de fundo da janela usando a cor de plano de fundo atual para o controle de exibição de lista. Se a cor do plano de fundo for o valor CLR_NONE, o controle list-view encaminhará a mensagem para a janela pai. |
| WM_GETDLGCODE | Retorna uma combinação dos valores DLGC_WANTTAB e DLGC_WANTARROWS. |
| WM_GETFONT | Retorna o identificador para a fonte de rótulo atual. |
| WM_HSCROLL | Rola o controle de exibição de lista horizontalmente. |
| WM_KEYDOWN | Processa a barra de espaços, ENTER e as teclas de seta e envia um código de notificação LVN_KEYDOWN para a janela pai. |
| WM_KILLFOCUS | Repinta o item de lista focado, se houver, e envia um código de notificação NM_KILLFOCUS para a janela pai. |
| WM_LBUTTONDBLCLK | Envia à janela pai um código de notificação NM_DBLCLK (modo de exibição de lista). |
| WM_LBUTTONDOWN | Processado de maneiras diferentes, dependendo se uma operação de clique ou arrastar está sendo iniciada. Para determinar qual operação está envolvida, o controle list-view entra em um loop de mensagem modal até que o botão seja liberado ou o mouse seja movido. No caso de um clique, o controle de exibição de lista pode alterar qual item tem o foco e quais itens são selecionados, levando em conta a posição do cursor, o estado das teclas SHIFT e CTRL e assim por diante. Em seguida, o controle de exibição de lista envia à janela pai um código de notificação NM_CLICK (modo de exibição de lista). Se o arrastar começar sobre um item, o controle de exibição de lista selecionará e definirá o foco para o item. Em seguida, ele envia um código de notificação LVN_BEGINDRAG para a janela pai. A janela pai é responsável por realmente executar a operação de arrastar. Se o arrastar começar sobre o plano de fundo da janela, o controle de exibição de lista entrará em outro loop de mensagem modal, permitindo que o usuário forme um retângulo arrastando o mouse. Os itens dentro do retângulo são selecionados. |
| WM_NCCREATE | Aloca e inicializa uma estrutura de dados interna e, em seguida, chama a função DefWindowProc. |
| WM_NCDESTROY | Libera recursos alocados pelo controle list-view. A menos que o estilo LVS_SHAREIMAGELISTS seja usado, isso inclui excluir as listas de imagens de tamanho completo e pequenas. |
| WM_NOTIFY | Processa códigos de notificação de controle de cabeçalho. |
| WM_PAINT | Exibe todos os itens na região de atualização. Para itens de retorno de chamada, o controle primeiro envia um código de notificação LVN_GETDISPINFO para a janela do proprietário para solicitar informações de exibição. Se o parâmetro wParam for não-NULL, o controle assume que o valor é um HDC e pinta usando esse contexto de dispositivo. |
| WM_RBUTTONDOWN | Processado da mesma maneira que a mensagem WM_LBUTTONDOWN, exceto que o controle envia um código de notificação NM_RCLICK (modo de exibição de lista) (em vez de NM_CLICK (modo de exibição de lista)) e um código de notificação de LVN_BEGINRDRAG (em vez de LVN_BEGINDRAG). Observe que o controle processa a mensagem de WM_RBUTTONUP correspondente e não a despacha. Os aplicativos, portanto, não podem ver essa mensagem, mesmo subclassificando o controle. |
| WM_SETFOCUS | Repinta o item de lista focado, se houver, e envia um código de notificação NM_SETFOCUS para a janela pai. |
| WM_SETFONT | Salva a alça de fonte especificada, encaminha a mensagem para a janela de cabeçalho, se houver, e repinta usando a nova fonte. |
| WM_SETREDRAW | Ativa ou desativa o redesenho. |
| WM_TIMER | Inicia a edição de um rótulo de item. Se o usuário clicar no rótulo do item focado, o controle de exibição de lista definirá um temporizador em vez de entrar no modo de edição imediatamente. O temporizador possibilita que o controle de exibição de lista não entre no modo de edição se o usuário clicar duas vezes no rótulo. |
| WM_VSCROLL | Rola o controle de exibição de lista verticalmente. |
| WM_WINDOWPOSCHANGED | Atualiza as barras de rolagem da janela. Se o modo de exibição atual for o modo de exibição de ícone ou ícone pequeno e o estilo LVS_AUTOARRANGE for especificado, o controle de exibição de lista também organizará os itens de lista. |
| WM_WININICHANGE | Processa alterações nas métricas do sistema. |