winuser.h


TrackMouseEvent

[Nuevo - Windows NT]

La función TrackMouseEvent envía (post) mensajes cuando el puntero del ratón abandona o pasa sobre una ventana durante una cantidad de tiempo especificado.

Sintaxis

BOOL TrackMouseEvent(
    LPTRACKMOUSEEVENT lpEventTrack  // puntero a estructura TRACKMOUSEEVENT
   );

Parámetros

lpEventTrack: puntero a estructura TRACKMOUSEEVENT.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError.

Los mensajes que la función puede enviar (post) son los siguientes:

Mensaje Significado
WM_MOUSEHOVER El ratón permanece sobre el área de cliente de la ventana durante el periodo de tiempo especificado en una llamada previa a TrackMouseEvent. El trazado termina cuando este mensaje es generado. La aplicación debe llamar a TrackMouseEvent de nuevo si requiere continuar el seguimiento del ratón sobre la ventana.
WM_MOUSELEAVE El ratón abandona el área de la ventana especificada en una llamada previa a TrackMouseEvent. Cualquier seguimiento requerido por TrackMouseEvent se cancela cuando este mensaje es generado. La aplicación debe llamar a TrackMouseEvent cuando el ratón vuelva a entrar en la ventana si necesita continuar el seguimiento del ratón sobre la ventana.

Observaciones

Se considera que el puntero del ratón se pasa sobre cuando permanece dentro de un rectángulo especificado durante un periodo de tiempo especificado. Llamar a SystemParametersInfo y usar los valores SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT y SPI_GETMOUSEHOVERTIME para recuperar el tamaño del rectángulo y el tiempo.