Mensagem 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.
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.
- GET_X_LPARAM(lParam): a coordenada x (ponto horizontal).
- GET_Y_LPARAM(lParam): a coordenada y (ponto vertical).
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 |
|