Función TrackMouseEvent (winuser.h)

Artículo
08/28/2023

Envía mensajes cuando se retira el puntero del mouse de una ventana o se mantiene sobre una ventana durante un período de tiempo especificado.

Nota La función _TrackMouseEvent llama a TrackMouseEvent si existe; de lo contrario, _TrackMouseEvent emula TrackMouseEvent.

Sintaxis

BOOL TrackMouseEvent(
  [in, out] LPTRACKMOUSEEVENT lpEventTrack
);

Parámetros

[in, out] lpEventTrack

Tipo: LPTRACKMOUSEEVENT

Puntero a una estructura TRACKMOUSEEVENT que contiene información de seguimiento.

Valor devuelto

Tipo: BOOL

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Se considera que el puntero del mouse se mantiene al mantener el puntero cuando permanece dentro de un rectángulo especificado durante un período de tiempo especificado. Llame a SystemParametersInfo. y use los valores SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT y SPI_GETMOUSEHOVERTIME para recuperar el tamaño del rectángulo y el tiempo.

La función puede publicar los siguientes mensajes.

Message	Descripción
WM_NCMOUSEHOVER	El mismo significado que WM_MOUSEHOVER excepto para el área no cliente de la ventana.
WM_NCMOUSELEAVE	El mismo significado que WM_MOUSELEAVE excepto para el área no cliente de la ventana.
WM_MOUSEHOVER	El mouse mantiene el mouse sobre el área de cliente de la ventana durante el período de tiempo especificado en una llamada anterior a TrackMouseEvent. El seguimiento del puntero se detiene cuando se genera este mensaje. La aplicación debe llamar a TrackMouseEvent de nuevo si se requiere un seguimiento adicional del comportamiento del puntero del mouse.
WM_MOUSELEAVE	El mouse dejó el área de cliente de la ventana especificada en una llamada anterior a TrackMouseEvent. Todo el seguimiento solicitado por TrackMouseEvent se cancela cuando se genera este mensaje. La aplicación debe llamar a TrackMouseEvent cuando el mouse vuelve a entrar en su ventana si requiere seguir haciendo un seguimiento del comportamiento de mantener el puntero del mouse.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-mouse-l1-1-0 (introducido en Windows 8)