Mensaje WM_POINTERCAPTURECHANGED

Se envía a una ventana que pierde la captura de un puntero de entrada.

Una ventana recibe este mensaje a través de la función WindowProc.

#define WM_POINTERCAPTURECHANGED           0x024C

Parámetros

wParam

Contiene información sobre el puntero de entrada que se está perdiendo. Use GET_POINTERID_WPARAM para obtener el identificador de puntero.

lParam

Contiene un identificador para la ventana que captura el puntero de entrada. Este valor puede ser NULL si la ventana ya no captura el puntero.

Si este mensaje se genera a partir del procesamiento interno, el valor puede ser el identificador de la ventana que recibe el mensaje.

Valor devuelto

Si una aplicación procesa este mensaje, debe devolver cero.

Si la aplicación no procesa este mensaje, debe llamar a DefWindowProc.

Observaciones

Una ventana debe usar esta notificación para detener el procesamiento de mensajes posteriores e iniciar cualquier limpieza necesaria para que se pierda el puntero. El procesamiento de gestos asociados al puntero también debe finalizarse (por ejemplo, llamando a StopInteractionContext) y los contactos restantes se vuelven a asociar a la ventana.

Normalmente, si una ventana recibe la notificación de WM_POINTERCAPTURECHANGED , no se reciben notificaciones posteriores relacionadas con el puntero de entrada. Por este motivo, no dependa de notificaciones emparejadas, como WM_POINTERENTER y WM_POINTERLEAVE.

WM_POINTERCAPTURECHANGED no incluye POINTER_INFO datos. Aparte de la marca POINTER_FLAG_CAPTURECHANGED que se establece, los datos devueltos por GetPointerInfo (o cualquier variante) son idénticos a los devueltos antes de la notificación.

Si la aplicación no procesa esta notificación, DefWindowProc puede generar uno o varios mensajes de WM_GESTURE o, si no se reconoce un gesto, DefWindowProc puede generar la entrada del mouse.

Si una aplicación consume selectivamente alguna entrada de puntero y pasa el resto a DefWindowProc, el comportamiento resultante no está definido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado	Winuser.h (incluya Windows.h)

Consulte también

Mensajes