Partilhar via

WM_POINTERCAPTURECHANGED mensagem

  • Artigo

Enviado para uma janela que está perdendo a captura de um ponteiro de entrada.

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

#define WM_POINTERCAPTURECHANGED           0x024C

Parâmetros

wParam

Contém informações sobre o ponteiro de entrada que está sendo perdido. Use GET_POINTERID_WPARAM para obter a ID do ponteiro.

lParam

Contém um identificador para a janela que está capturando o ponteiro de entrada. Esse valor pode ser NULL se o ponteiro não estiver mais sendo capturado pela janela.

Se esta mensagem for gerada a partir de processamento interno, o valor pode ser o identificador da janela que recebe a mensagem.

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

Uma janela deve usar essa notificação para parar de processar mensagens subsequentes e iniciar qualquer limpeza necessária para que o ponteiro seja perdido. O processamento de gestos associados ao ponteiro também deve ser encerrado (por exemplo, chamando StopInteractionContext) e os contatos restantes devem ser reassociados à janela.

Normalmente, se uma janela receber a notificação de WM_POINTERCAPTURECHANGED, nenhuma notificação subsequente relacionada ao ponteiro de entrada será recebida. Por isso, não dependa de notificações emparelhadas, como WM_POINTERENTER e WM_POINTERLEAVE.

WM_POINTERCAPTURECHANGED não inclui dados POINTER_INFO. Além do sinalizador de POINTER_FLAG_CAPTURECHANGED que está sendo definido, os dados retornados por GetPointerInfo (ou qualquer variante) são idênticos aos retornados antes da notificação.

Se o aplicativo não processar essa notificação, DefWindowProc pode gerar uma ou mais mensagens WM_GESTURE ou, se um gesto não for reconhecido, DefWindowProc pode gerar entrada do mouse.

Se um aplicativo consome seletivamente alguma entrada de ponteiro e passa o restante para DefWindowProc , o comportamento resultante é indefinido.

Requerimentos

Exigência Valor
Cliente mínimo suportado
 Windows 8 [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado
 Windows Server 2012 [apenas aplicações de ambiente de trabalho]
Cabeçalho
Winuser.h (inclui Windows.h)

Ver também

Mensagens