Mensagem WM_NCPOINTERUP

Postado quando um ponteiro que fez contato com a área não-cliente de uma janela interrompe o contato. A mensagem tem como alvo a janela sobre a qual o ponteiro faz contato e o ponteiro é, nesse ponto, implicitamente capturado para a janela, de modo que a janela continue a receber entrada para o ponteiro até que ele interrompa o contato, incluindo a notificação WM_NCPOINTERUP.

Se uma janela tiver capturado esse ponteiro, essa mensagem não será publicada. 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 seu 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, confira Escrevendo aplicativos Win32 de Alto DPI.

#define WM_NCPOINTERUP               0x0243

Parâmetros

wParam

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

GET_POINTERID_WPARAM(wParam): identificador de ponteiro

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

lParam

Contém a localização 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 mais complexa do ponteiro. Sempre que possível, um aplicativo deve usar as informações completas da área do ponteiro em vez da localização do ponto.

Utilize as seguintes macros para obter 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 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 acerto incluído na mensagem. Normalmente, os aplicativos não devem precisar lidar com essa mensagem.

Requisitos

Confira também

Mensagens