Compartilhar via

Mensagem WM_POINTERENTER

  • Artigo

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.

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.

#define WM_POINTERENTER                 0x0249

Parâmetros

wParam

Contém o identificador de ponteiro e as informações adicionais. Use as macros a seguir para recuperar informações específicas no parâmetro wParam.

  • GET_POINTERID_WPARAM(wParam): o identificador do ponteiro.
  • IS_POINTER_NEW_WPARAM(wParam): indica se essa mensagem é a primeira mensagem gerada por um novo ponteiro que entra no intervalo de detecção (focalizar).
  • IS_POINTER_INRANGE_WPARAM(wParam): indica se essa mensagem foi gerada por um ponteiro que não deixou o intervalo de detecção. Esse sinalizador é sempre definido para mensagens WM_POINTERENTER .
  • IS_POINTER_INCONTACT_WPARAM(wParam): um sinalizador que indica se essa mensagem foi gerada por um ponteiro que está em contato. Esse sinalizador não está definido para um ponteiro no intervalo de detecção (focalizar).

lParam

Contém o local do ponto do ponteiro.

Observação

Como o ponteiro pode fazer contato com o dispositivo em uma área não trivial, esse local de ponto pode ser uma simplificação de uma área de ponteiro mais complexa. Sempre que possível, um aplicativo deve usar as informações completas da área do ponteiro em vez do local do ponto.

Use as macros a seguir para recuperar as coordenadas de tela física do ponto.

Retornar valor

Se um aplicativo processar essa mensagem, ela deverá retornar zero.

Se o aplicativo não processar essa mensagem, ele deverá chamar DefWindowProc.

Comentários

A notificação WM_POINTERENTER pode ser usada por uma janela para fornecer comentários ao usuário enquanto o ponteiro está sobre sua superfície ou para reagir de outra forma à presença de um ponteiro sobre sua superfície.

Essa notificação só é enviada para a janela que está recebendo entrada para o ponteiro. A tabela a seguir lista algumas das situações em que essa notificação é enviada.

Ação Conjunto de sinalizadores Notificações enviadas para
Um novo ponteiro entra no intervalo de detecção (focalizar). IS_POINTER_NEW_WPARAM
IS_POINTER_INRANGE_WPARAM
 Janela sobre a qual o ponteiro entra no intervalo de detecção.
Um ponteiro focalizado cruza os limites da janela. IS_POINTER_INRANGE_WPARAM
 Janela na qual o ponteiro cruzou.

! [Importante]
Quando uma janela perde a captura de um ponteiro e recebe a notificação WM_POINTERCAPTURECHANGED , ela normalmente não receberá mais notificações. Por esse motivo, é importante que você não faça suposições com base em WM_POINTERDOWN/pares uniformemente WM_POINTERUP ou WM_POINTERENTER/ notificaçõesWM_POINTERLEAVE.

Quando as entradas vêm do mouse, como resultado da integração de mensagens de mouse e ponteiro, WM_POINTERENTER não é enviado.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclui Windows.h)

Confira também

Mensagens

Referência

GET_POINTERID_WPARAM

IS_POINTER_NEW_WPARAM

IS_POINTER_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM