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.

Tópicos relacionados

Referência de mensagem de entrada de ponteiro