Compartir a través de


Estructura TRACKMOUSEEVENT (winuser.h)

Lo usa la función TrackMouseEvent para realizar un seguimiento cuando el puntero del mouse sale de una ventana o mantiene el puntero sobre una ventana durante un período de tiempo especificado.

Sintaxis

typedef struct tagTRACKMOUSEEVENT {
  DWORD cbSize;
  DWORD dwFlags;
  HWND  hwndTrack;
  DWORD dwHoverTime;
} TRACKMOUSEEVENT, *LPTRACKMOUSEEVENT;

Miembros

cbSize

Tipo: DWORD

Tamaño de la estructura TRACKMOUSEEVENT , en bytes.

dwFlags

Tipo: DWORD

Los servicios solicitados. Este miembro puede ser una combinación de los valores siguientes.

Valor Significado
TME_CANCEL
0x80000000
El autor de la llamada quiere cancelar una solicitud de seguimiento anterior. El autor de la llamada también debe especificar el tipo de seguimiento que desea cancelar. Por ejemplo, para cancelar el seguimiento del puntero, el autor de la llamada debe pasar las marcas TME_CANCEL y TME_HOVER .
TME_HOVER
0x00000001
El autor de la llamada quiere mantener el puntero en la notificación. La notificación se entrega como un mensaje de WM_MOUSEHOVER .

Si el autor de la llamada solicita el seguimiento del puntero mientras el seguimiento del mouse ya está activo, se restablecerá el temporizador de desplazamiento.

Esta marca se omite si el puntero del mouse no está sobre la ventana o área especificadas.

TME_LEAVE
0x00000002
El autor de la llamada quiere dejar la notificación. La notificación se entrega como un mensaje de WM_MOUSELEAVE . Si el mouse no está sobre la ventana o área especificada, se genera inmediatamente una notificación de salida y no se realiza ningún seguimiento adicional.
TME_NONCLIENT
0x00000010
El autor de la llamada quiere mantener el puntero y dejar la notificación para las áreas que no son cliente. La notificación se entrega como mensajes WM_NCMOUSEHOVER y WM_NCMOUSELEAVE .
TME_QUERY
0x40000000
La función rellena la estructura en lugar de tratarla como una solicitud de seguimiento. La estructura se rellena de tal forma que si se hubiera pasado esa estructura a TrackMouseEvent, generaría el seguimiento actual. La única anomalía es que el tiempo de espera de desplazamiento devuelto siempre es el tiempo de espera real y no HOVER_DEFAULT, si se especificó HOVER_DEFAULT durante la solicitud trackMouseEvent original.

hwndTrack

Tipo: HWND

Identificador de la ventana a la que se va a realizar el seguimiento.

dwHoverTime

Tipo: DWORD

Tiempo de espera del puntero (si TME_HOVER se especificó en dwFlags), en milisegundos. Puede ser HOVER_DEFAULT, lo que significa usar el tiempo de espera predeterminado del sistema.

Comentarios

El tiempo de espera predeterminado del sistema es inicialmente el tiempo desplegable del menú, que es de 400 milisegundos. Puede llamar a SystemParametersInfo y usar SPI_GETMOUSEHOVERTIME para recuperar el tiempo de espera predeterminado del puntero.

El rectángulo de desplazamiento predeterminado del sistema es el mismo que el rectángulo de doble clic. Puede llamar a SystemParametersInfo y usar SPI_GETMOUSEHOVERWIDTH y SPI_GETMOUSEHOVERHEIGHT para recuperar el tamaño del rectángulo en el que el puntero del mouse debe permanecer para que TrackMouseEvent genere un mensaje WM_MOUSEHOVER .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado winuser.h (incluya Windows.h)

Consulte también

Entrada de mouse