Compartilhar via


Mensagem WM_POINTERCAPTURECHANGED

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

Uma janela recebe essa mensagem por meio da 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 poderá ser NULL se o ponteiro não estiver mais sendo capturado pela janela.

Se essa mensagem for gerada a partir do processamento interno, o valor poderá ser o identificador da janela que recebe a mensagem.

Retornar valor

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

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

Comentários

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

Normalmente, se uma janela receber a notificação 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 POINTER_INFO dados. Além do sinalizador 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 poderá gerar uma ou mais mensagens WM_GESTURE ou, se um gesto não for reconhecido, DefWindowProc poderá gerar entrada do mouse.

Se um aplicativo consumir seletivamente alguma entrada de ponteiro e passar o restante para DefWindowProc, o comportamento resultante será indefinido.

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