Mensagens
Os tópicos nesta seção fornecem as especificações de referência para notificações e mensagens de entrada de ponteiro específicas.
Nesta seção
| Tópico | Descrição |
|---|---|
|
DM_POINTERHITTEST |
Enviado para uma janela, quando a entrada de ponteiro é detectada pela primeira vez, para determinar o destino de entrada mais provável para Manipulação Direta. |
|
WM_NCPOINTERDOWN |
Postado quando um ponteiro faz contato pela área não cliente de uma janela. A mensagem direciona a janela sobre a qual o ponteiro faz contato. O ponteiro é capturado implicitamente na janela para que a janela continue recebendo entrada para o ponteiro até que ele interrompa o contato. Se uma janela tiver capturado esse ponteiro, essa mensagem não será postada. Em vez disso, um WM_POINTERDOWN é postado na janela que capturou esse ponteiro. Importante: Os aplicativos da área de trabalho devem estar cientes do DPI. Se o aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte Escrevendo aplicativos Win32 de Alto DPI. |
|
WM_NCPOINTERUP |
Postado quando um ponteiro que fez contato sobre a área não cliente de uma janela interrompe o contato. A mensagem direciona a janela sobre a qual o ponteiro faz contato e o ponteiro é, nesse ponto, implicitamente capturado para a janela para que a janela continue a receber entrada para o ponteiro até que ela interrompa o contato, incluindo a notificação de WM_NCPOINTERUP . Se uma janela tiver capturado esse ponteiro, essa mensagem não será postada. Em vez disso, um WM_POINTERUP é postado na janela que capturou esse ponteiro. Importante: Os aplicativos da área de trabalho devem estar cientes do DPI. Se o aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte Escrevendo aplicativos Win32 de Alto DPI. |
|
WM_NCPOINTERUPDATE |
Postado para fornecer uma atualização em um ponteiro que fez contato sobre a área não cliente de uma janela ou quando um contato não capturado pairando se move sobre a área não cliente de uma janela. Enquanto o ponteiro está passando o mouse, a mensagem é direcionada para qualquer janela em que o ponteiro esteja sobre. Enquanto o ponteiro está em contato com a superfície, o ponteiro é implicitamente capturado para a janela sobre a qual o ponteiro fez contato e essa janela continua recebendo entrada para o ponteiro até que ele interrompa o contato. Se uma janela tiver capturado esse ponteiro, essa mensagem não será postada. Em vez disso, um WM_POINTERUPDATE é postado na janela que capturou esse ponteiro. Importante: Os aplicativos da área de trabalho devem estar cientes do DPI. Se o aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte Escrevendo aplicativos Win32 de Alto DPI. |
|
WM_PARENTNOTIFY |
Enviado para uma janela quando ocorre uma ação significativa em uma janela descendente. Essa mensagem agora é estendida para incluir o evento WM_POINTERDOWN . Quando a janela filho está sendo criada, o sistema envia WM_PARENTNOTIFY pouco antes da função CreateWindow ou CreateWindowEx que cria a janela retorna. Quando a janela filho está sendo destruída, o sistema envia a mensagem antes que qualquer processamento para destruir a janela ocorra. Uma janela recebe essa mensagem por meio da função WindowProc. Importante: Os aplicativos da área de trabalho devem estar cientes do DPI. Se o aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte Escrevendo aplicativos Win32 de Alto DPI. |
|
WM_POINTERACTIVATE |
Enviado para uma janela inativa quando um ponteiro primário gera um WM_POINTERDOWN pela janela. Desde que a mensagem permaneça sem tratamento, ela percorre a cadeia de janelas pai até chegar à janela de nível superior. Os aplicativos podem responder a essa mensagem para especificar se desejam ser ativados. Uma janela recebe essa mensagem por meio da função WindowProc. |
|
WM_POINTERCAPTURECHANGED |
Enviado para uma janela que está perdendo a captura de um ponteiro de entrada. Uma janela recebe essa mensagem por meio da função WindowProc. |
|
WM_POINTERDEVICECHANGE |
Enviado para uma janela quando há uma alteração nas configurações de um monitor que tem um digitalizador anexado a ele. Esta mensagem contém informações sobre o dimensionamento do modo de exibição. |
|
WM_POINTERDEVICEINRANGE |
Enviado para uma janela quando um dispositivo de ponteiro é detectado dentro do intervalo de um digitalizador de entrada. Esta mensagem contém informações sobre o dispositivo e sua proximidade. |
|
WM_POINTERDEVICEOUTOFRANGE |
Enviado para uma janela quando um dispositivo de ponteiro saiu do intervalo de um digitalizador de entrada. Esta mensagem contém informações sobre o dispositivo e sua proximidade. |
|
WM_POINTERDOWN |
Postado quando um ponteiro faz contato sobre a área do cliente de uma janela. Essa mensagem de entrada direciona a janela sobre a qual o ponteiro faz contato e o ponteiro é implicitamente capturado na janela para que a janela continue a receber entrada para o ponteiro até que ele interrompa o contato. Uma janela recebe essa mensagem por meio da função WindowProc. Importante: Os aplicativos da área de trabalho devem estar cientes do DPI. Se o aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte Escrevendo aplicativos Win32 de Alto DPI. |
|
WM_POINTERENTER |
Enviado para uma janela quando um novo ponteiro entra no intervalo de detecção sobre a janela (focalizar) ou quando um ponteiro existente se move dentro dos limites da janela. |
|
WM_POINTERLEAVE |
Enviado para uma janela quando um ponteiro deixa o intervalo de detecção sobre a janela (focalizar) ou quando um ponteiro se move para fora dos limites da janela. |
|
WM_POINTERROUTEDAWAY |
Ocorre no processo que recebe entrada quando a entrada do ponteiro é roteada para outro processo. |
|
WM_POINTERROUTEDRELEASED |
Enviado para todos os processos (configurados para encadeamento entre processos por meio de AddContentWithCrossProcessChaining e não manipulando a entrada de ponteiro) nunca associados a uma ID de ponteiro específica, quando uma mensagem de WM_POINTERUP é recebida no processo atual. |
|
WM_POINTERROUTEDTO |
Enviado quando a entrada de ponteiro contínua, para uma ID de ponteiro existente, faz a transição de um processo para outro em todo o conteúdo configurado para encadeamento entre processos (AddContentWithCrossProcessChaining). |
|
WM_POINTERUP |
Postado quando um ponteiro que fez contato sobre a área do cliente de uma janela interrompe o contato. Essa mensagem de entrada tem como destino a janela sobre a qual o ponteiro faz contato e o ponteiro é, nesse ponto, implicitamente capturado para a janela para que a janela continue a receber mensagens de entrada, incluindo a notificação WM_POINTERUP para o ponteiro até que ele interrompa o contato. Uma janela recebe essa mensagem por meio da função WindowProc. Importante: Os aplicativos da área de trabalho devem estar cientes do DPI. Se o aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte Escrevendo aplicativos Win32 de Alto DPI. |
|
WM_POINTERUPDATE |
Postado para fornecer uma atualização em um ponteiro que fez contato sobre a área do cliente de uma janela ou em um ponteiro nãocapturado pairando sobre a área do cliente de uma janela. Enquanto o ponteiro está passando o mouse, a mensagem é direcionada para qualquer janela em que o ponteiro esteja sobre. Enquanto o ponteiro está em contato com a superfície, o ponteiro é implicitamente capturado para a janela sobre a qual o ponteiro fez contato e essa janela continua recebendo entrada para o ponteiro até que ele interrompa o contato. Importante: Os aplicativos da área de trabalho devem estar cientes do DPI. Se o aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte Escrevendo aplicativos Win32 de Alto DPI. |
|
WM_POINTERWHEEL |
Postado na janela com foco de teclado em primeiro plano quando uma roda de rolagem é girada. Uma janela recebe essa mensagem por meio da função WindowProc. Importante: Os aplicativos da área de trabalho devem estar cientes do DPI. Se o aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte Escrevendo aplicativos Win32 de Alto DPI. |
|
WM_POINTERHWHEEL |
Postado na janela com foco de teclado em primeiro plano quando uma roda de rolagem horizontal é girada. Uma janela recebe essa mensagem por meio da função WindowProc. Importante: Os aplicativos da área de trabalho devem estar cientes do DPI. Se o aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte Escrevendo aplicativos Win32 de Alto DPI. |
|
WM_TOUCHHITTESTING |
Enviado para uma janela em um toque para baixo para determinar o destino de toque mais provável. |