Compartir a través de

Mensaje WM_POINTERLEAVE

  • Artículo

Se envía a una ventana cuando un puntero deja el intervalo de detección sobre la ventana (mantener el puntero) o cuando un puntero se mueve fuera de los límites de la ventana.

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

Importante
Las aplicaciones de escritorio deben ser compatibles con PPP. Si la aplicación no es compatible con PPP, las coordenadas de pantalla contenidas en los mensajes de puntero y las estructuras relacionadas pueden parecer inexactas debido a la virtualización de PPP. La virtualización de PPP proporciona compatibilidad de escalado automático con aplicaciones que no son compatibles con PPP y están activas de forma predeterminada (los usuarios pueden desactivarla). Para obtener más información, consulta Escribir aplicaciones Win32 de alto PPP.

#define WM_POINTERLEAVE                 0x024A

Parámetros

wParam

Contiene el identificador de puntero y la información adicional. Use las siguientes macros para recuperar esta información.

  • GET_POINTERID_WPARAM(wParam): el identificador del puntero.
  • IS_POINTER_INRANGE_WPARAM(wParam): indica si un puntero que no ha dejado el intervalo de detección ha generado este mensaje. Esta marca no se establece cuando el puntero deja el intervalo de detección de la ventana.
  • IS_POINTER_INCONTACT_WPARAM(wParam): una marca que indica si un puntero que está en contacto generó este mensaje. Esta marca no está establecida para un puntero en el intervalo de detección (mantener el puntero).

lParam

Contiene la ubicación de punto del puntero.

Nota:

Dado que el puntero puede ponerse en contacto con el dispositivo a través de un área no trivial, esta ubicación de punto puede ser una simplificación de un área de puntero más compleja. Siempre que sea posible, una aplicación debe usar la información completa del área de puntero en lugar de la ubicación del punto.

Use las macros siguientes para recuperar las coordenadas de pantalla física del punto.

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 puede usar la notificación WM_POINTERLEAVE para cambiar el modo o detener cualquier comentario al usuario mientras el puntero está sobre la superficie de la ventana.

Esta notificación solo se envía a la ventana que recibe la entrada para el puntero. En la tabla siguiente se enumeran algunas de las situaciones en las que se envía esta notificación.

Acción Conjunto de marcas Notificaciones enviadas a
Un puntero que mantiene el puntero cruza los límites de la ventana. IS_POINTER_INRANGE_WPARAM Ventana fuera de cuyo límite se movió el puntero.
Un puntero sale del intervalo de detección. N/D Ventana para la que el puntero deja el intervalo de detección.

Importante
Cuando una ventana pierde la captura de un puntero y recibe la notificación de WM_POINTERCAPTURECHANGED , normalmente no recibirá más notificaciones. Por este motivo, es importante que no realice ninguna suposición basada en WM_POINTERDOWN emparejadosuniformementeWM_POINTERUP/ o WM_POINTERENTER/ notificacionesWM_POINTERLEAVE.

Si el contacto se mantiene con el digitalizador de entrada y el puntero se mueve fuera de la ventana, no se genera WM_POINTERLEAVE . WM_POINTERLEAVE solo se genera cuando un puntero al mantener el puntero cruza los límites de la ventana o se finaliza el contacto.

WM_POINTERLEAVE se publica en la cola de mensajes publicados si la entrada se origina en un dispositivo del mouse.

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

Reference

GET_POINTERID_WPARAM

IS_POINTER_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM