WM_POINTERENTER mensagem

Enviado para uma janela quando um novo ponteiro entra no intervalo de deteção sobre a janela (pairar) ou quando um ponteiro existente se move dentro dos limites da janela.

Uma janela recebe esta mensagem através da sua função WindowProc.

! [Importante]
As aplicações de ambiente de trabalho devem estar cientes do DPI. Se seu aplicativo não reconhece DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas podem parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não reconhecem DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte escrevendo High-DPI aplicativos Win32.

#define WM_POINTERENTER                 0x0249

Parâmetros

wParam

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

• GET_POINTERID_WPARAM(wParam): o identificador de ponteiro.
• IS_POINTER_NEW_WPARAM(wParam): indica se esta mensagem é a primeira mensagem gerada por um novo ponteiro que entra no intervalo de deteção (focalização).
• IS_POINTER_INRANGE_WPARAM(wParam): indica se esta mensagem foi gerada por um ponteiro que não saiu do intervalo de deteção. Este sinalizador é sempre definido para WM_POINTERENTER mensagens.
• IS_POINTER_INCONTACT_WPARAM(wParam): um sinalizador que indica se esta mensagem foi gerada por um ponteiro que está em contacto. Este sinalizador não está definido para um ponteiro no intervalo de deteção (focalização).

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, essa localização do 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 da localização do ponto.

Use as macros a seguir para recuperar as coordenadas físicas da tela do ponto.

• GET_X_LPARAM(lParam): a coordenada x (ponto horizontal).
• GET_Y_LPARAM(lParam): a coordenada y (ponto vertical).

Valor de retorno

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

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

Comentários

A notificação WM_POINTERENTER pode ser usada por uma janela para fornecer feedback ao usuário enquanto o ponteiro está sobre sua superfície ou para reagir à 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.

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

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

Requerimentos

Ver também

Mensagens

de referência

GET_POINTERID_WPARAM

IS_POINTER_NEW_WPARAM

IS_POINTER_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM