Freigeben über

TRACKMOUSEEVENT-Struktur (winuser.h)

  • Artikel

Wird von der TrackMouseEvent-Funktion verwendet, um nachzuverfolgen, wann der Mauszeiger ein Fenster verlässt oder für einen bestimmten Zeitraum auf ein Fenster zeigt.

Syntax

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

Member

cbSize

Art: DWORD

Die Größe der TRACKMOUSEEVENT-Struktur in Bytes.

dwFlags

Art: DWORD

Die angeforderten Dienste. Dieser Member kann eine Kombination der folgenden Werte sein.

Wert Bedeutung
TME_CANCEL
0x80000000
 Der Anrufer möchte eine vorherige Nachverfolgungsanforderung abbrechen. Der Aufrufer sollte auch den Typ der Nachverfolgung angeben, die er abbrechen möchte. Um beispielsweise die Nachverfolgung mit dem Mauszeiger abzubrechen, muss der Aufrufer die TME_CANCEL - und TME_HOVER-Flags übergeben.
TME_HOVER
0x00000001
 Der Aufrufer möchte eine Benachrichtigung mit dem Mauszeiger zeigen. Die Benachrichtigung wird als WM_MOUSEHOVER Nachricht übermittelt.

Wenn der Aufrufer die Hover-Nachverfolgung anfordert, während die Hover-Nachverfolgung bereits aktiv ist, wird der Hover-Timer zurückgesetzt.

Dieses Flag wird ignoriert, wenn sich der Mauszeiger nicht über dem angegebenen Fenster oder Bereich befindet.
TME_LEAVE
0x00000002
 Der Anrufer möchte die Benachrichtigung verlassen. Die Benachrichtigung wird als WM_MOUSELEAVE Nachricht übermittelt. Wenn sich die Maus nicht über dem angegebenen Fenster oder Bereich befindet, wird sofort eine Benachrichtigung zum Verlassen generiert, und es wird keine weitere Nachverfolgung durchgeführt.
TME_NONCLIENT
0x00000010
 Der Aufrufer möchte mit dem Mauszeiger zeigen und die Benachrichtigung für die Nichtclientbereiche verlassen. Benachrichtigungen werden als WM_NCMOUSEHOVER - und WM_NCMOUSELEAVE-Nachrichten übermittelt.
TME_QUERY
0x40000000
 Die Funktion füllt die Struktur aus, anstatt sie als Nachverfolgungsanforderung zu behandeln. Die Struktur ist so gefüllt, dass die aktuelle Nachverfolgung generiert würde, wenn diese Struktur an TrackMouseEvent übergeben worden wäre. Die einzige Anomalie besteht darin, dass das zurückgegebene Hover-Timeout immer das tatsächliche Timeout und nicht HOVER_DEFAULT ist, wenn HOVER_DEFAULT während der ursprünglichen TrackMouseEvent-Anforderung angegeben wurde.

hwndTrack

Typ: HWND

Ein Handle für das zu verfolgende Fenster.

dwHoverTime

Art: DWORD

Das Hover-Timeout (wenn TME_HOVER in dwFlags angegeben wurde) in Millisekunden. Kann HOVER_DEFAULT werden, was bedeutet, dass das Standardmäßige Mauszeigertimeout des Systems verwendet wird.

Hinweise

Das Standardmäßige Mauszeigertimeout des Systems ist zunächst die Dropdownzeit des Menüs, die 400 Millisekunden beträgt. Sie können SystemParametersInfo aufrufen und SPI_GETMOUSEHOVERTIME verwenden, um das standardmäßige Hover-Timeout abzurufen.

Das Standardmäßige Hover-Rechteck des Systems ist mit dem Doppelklickrechteck identisch. Sie können SystemParametersInfo aufrufen und SPI_GETMOUSEHOVERWIDTH und SPI_GETMOUSEHOVERHEIGHT verwenden, um die Größe des Rechtecks abzurufen, in dem der Mauszeiger bleiben muss, damit TrackMouseEvent eine WM_MOUSEHOVER Nachricht generiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile winuser.h (einschließlich Windows.h)

Weitere Informationen

Mauseingabe