Compartilhar via


Mensagem WM_NCPOINTERDOWN

Postado quando um ponteiro faz contato sobre a á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 a receber entrada para o ponteiro até que ele interrompa o contato.

Se uma janela tiver capturado o mouse, 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 Como escrever aplicativos Win32 de Alta DPI.

#define WM_NCPOINTERDOWN                 0x0242

Parâmetros

wParam

Contém o identificador de ponteiro e informações adicionais. Use as macros a seguir para recuperar essas informações.

GET_POINTERID_WPARAM(wParam): identificador de ponteiro.

HIWORD(wParam): valor de teste de ocorrência retornado do processamento da mensagem de WM_NCHITTEST.

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.

Valor retornado

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

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

Comentários

Se o aplicativo não processar essa mensagem, DefWindowProc poderá executar uma ou mais ações do sistema, dependendo do resultado do teste de ocorrência incluído na mensagem. Normalmente, os aplicativos não devem precisar lidar com essa mensagem.

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