Mensagem WM_NCPOINTERUPDATE

Postado para fornecer uma atualização sobre um ponteiro que fez contato sobre a área não cliente de uma janela, ou quando um contato focalizado não capturado se move sobre a área não cliente de uma janela. Enquanto o ponteiro está focalizando, a mensagem tem como alvo qualquer janela em que o ponteiro esteja terminado. Enquanto o ponteiro está em contato com a superfície, o ponteiro é capturado implicitamente para a janela sobre a qual o ponteiro fez contato, e essa janela continua a receber entrada para o ponteiro até que ele interrompa o contato.

Se uma janela tiver capturado esse ponteiro, essa mensagem não será publicada. Em vez disso, um WM_POINTERUPDATE é 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_NCPOINTERUPDATE                 0x0241

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