MOUSEINPUT-Struktur (winuser.h)

Enthält Informationen zu einem simulierten Mausereignis.

Syntax

typedef struct tagMOUSEINPUT {
  LONG      dx;
  LONG      dy;
  DWORD     mouseData;
  DWORD     dwFlags;
  DWORD     time;
  ULONG_PTR dwExtraInfo;
} MOUSEINPUT, *PMOUSEINPUT, *LPMOUSEINPUT;

Elemente

dx

Typ: LONG

Die absolute Position der Maus oder die Menge der Bewegung seit dem letzten Mausereignis wurde generiert, abhängig vom Wert des dwFlags-Elements . Absolute Daten werden als x-Koordinate der Maus angegeben. Relative Daten werden als Die Anzahl der verschobenen Pixel angegeben.

dy

Typ: LONG

Die absolute Position der Maus oder die Menge der Bewegung seit dem letzten Mausereignis wurde generiert, abhängig vom Wert des dwFlags-Elements . Absolute Daten werden als Y-Koordinate der Maus angegeben. Relative Daten werden als Die Anzahl der verschobenen Pixel angegeben.

mouseData

Art: DWORD

Wenn dwFlagsMOUSEEVENTF_WHEEL enthält, gibt MouseData die Menge der Radbewegung an. Ein positiver Wert gibt an, dass das Rad vorwärts gedreht wurde, weg vom Benutzer; Ein negativer Wert gibt an, dass das Rad rückwärts in Richtung des Benutzers gedreht wurde. Ein Radklick wird als WHEEL_DELTA definiert, was 120 ist.

Windows Vista: Wenn dwFlagsMOUSEEVENTF_HWHEEL enthält, gibt dwData die Menge der Radbewegung an. Ein positiver Wert gibt an, dass das Rad nach rechts gedreht wurde; Ein negativer Wert gibt an, dass das Rad nach links gedreht wurde. Ein Radklick wird als WHEEL_DELTA definiert, was 120 ist.

Wenn dwFlags keine MOUSEEVENTF_WHEEL, MOUSEEVENTF_XDOWN oder MOUSEEVENTF_XUP enthält, sollte mouseData null sein.

Wenn dwFlagsMOUSEEVENTF_XDOWN oder MOUSEEVENTF_XUP enthält, gibt MouseData an, welche X-Tasten gedrückt oder losgelassen wurden. Dieser Wert kann eine beliebige Kombination der folgenden Flags sein.

dwFlags

Art: DWORD

Eine Reihe von Bitkennzeichnungen, die verschiedene Aspekte von Mausklicks und Tastenklicks angeben. Die Bits in diesem Element können eine beliebige vernünftige Kombination der folgenden Werte sein.

Die Bitkennzeichnungen, die den Status der Maustaste angeben, werden so festgelegt, dass Änderungen am Status und nicht fortlaufende Bedingungen angegeben werden. Wenn beispielsweise die linke Maustaste gedrückt und gedrückt gehalten wird, wird MOUSEEVENTF_LEFTDOWN festgelegt, wenn die linke Taste zum ersten Mal gedrückt wird, aber nicht für nachfolgende Bewegungen. Ebenso wird MOUSEEVENTF_LEFTUP nur festgelegt, wenn die Schaltfläche zum ersten Mal losgelassen wird.

Sie können sowohl das MOUSEEVENTF_WHEEL-Flagals auch MOUSEEVENTF_XDOWN oder MOUSEEVENTF_XUP Flags nicht gleichzeitig im dwFlags-Parameter angeben, da beide die Verwendung des MouseData-Felds erfordern.

time

Art: DWORD

Der Zeitstempel für das Ereignis in Millisekunden. Wenn dieser Parameter 0 ist, stellt das System einen eigenen Zeitstempel bereit.

dwExtraInfo

Typ: ULONG_PTR

Ein zusätzlicher Wert, der dem Mausereignis zugeordnet ist. Eine Anwendung ruft GetMessageExtraInfo auf, um diese zusätzlichen Informationen abzurufen.

Bemerkungen

Wenn die Maus bewegt wurde, angegeben durch MOUSEEVENTF_MOVE, dx und dy geben Informationen zu dieser Bewegung an. Die Informationen werden als absolute oder relative ganzzahlige Werte angegeben.

Wenn MOUSEEVENTF_ABSOLUTE Wert angegeben ist, enthalten dx und dy normalisierte absolute Koordinaten zwischen 0 und 65.535. Die Ereignisprozedur ordnet diese Koordinaten der Anzeigeoberfläche zu. Die Koordinate (0,0) wird der oberen linken Ecke der Anzeigeoberfläche zugeordnet. die Koordinate (65535.65535) der unteren rechten Ecke zugeordnet ist. In einem Multimonitorsystem werden die Koordinaten dem primären Monitor zugeordnet.

Wenn MOUSEEVENTF_VIRTUALDESK angegeben ist, werden die Koordinaten dem gesamten virtuellen Desktop zugeordnet.

Wenn der wert MOUSEEVENTF_ABSOLUTE nicht angegeben ist, geben dx und dy die Bewegung relativ zum vorherigen Mausereignis an (die letzte gemeldete Position). Positive Werte bedeuten, dass die Maus nach rechts (oder nach unten) verschoben wird. negative Werte bedeuten, dass die Maus nach links verschoben (oder nach oben) verschoben wird.

Relative Mausbewegung unterliegt den Auswirkungen der Mausgeschwindigkeit und der Schwellenwerte für zwei Maus. Ein Benutzer legt diese drei Werte mit dem Zeiger "Geschwindigkeit " des Eigenschaftenblatts "Mauseigenschaften " der Systemsteuerung fest. Sie können diese Werte mithilfe der SystemParametersInfo-Funktion abrufen und festlegen.

Das System wendet zwei Tests auf die angegebene relative Mausbewegung an. Wenn der angegebene Abstand entlang der x- oder y-Achse größer als der erste Mausschwellenwert ist und die Mausgeschwindigkeit nicht null ist, verdoppelt das System den Abstand. Wenn der angegebene Abstand entlang der x- oder y-Achse größer als der zweite Mausschwellenwert ist und die Mausgeschwindigkeit gleich zwei ist, verdoppelt das System den Abstand, der sich aus der Anwendung des ersten Schwellenwerttests ergibt. So ist es möglich, dass das System die angegebene relative Mausbewegung entlang der x- oder y-Achse um bis zu viermal multiplizieren kann.

Anforderungen

Siehe auch

Konzeptionelle

GetMessageExtraInfo

EINGABE

Tastatureingaben

Referenz

SendInput