MOUSEINPUT-Struktur (winuser.h)

  • Artikel

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;

Member

dx

Typ: LONG

Die absolute Position der Maus oder der Bewegungsumfang seit dem letzten Mausereignis, 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 der Bewegungsumfang seit dem letzten Mausereignis, 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 bedeutet, dass das Rad von dem*der Benutzer*in weg vorwärts gedreht wurde, ein negativer Wert bedeutet, dass das Rad zu dem*der Benutzer*in hin rückwärts gedreht wurde. Ein Radklick ist als WHEEL_DELTA definiert, d. h. 120.

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 ist als WHEEL_DELTA definiert, d. h. 120.

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-Schaltflächen gedrückt oder freigegeben wurden. Dieser Wert kann eine beliebige Kombination der folgenden Flags sein.

Wert Bedeutung
XBUTTON1
0x0001		 Legen Sie fest, ob die erste X-Taste gedrückt oder freigegeben wird.
XBUTTON2
0x0002		 Legen Sie fest, ob die zweite X-Taste gedrückt oder freigegeben wird.

dwFlags

Art: DWORD

Eine Reihe von Bitflags, die verschiedene Aspekte von Mausbewegungen und Schaltflächenklicks angeben. Die Bits in diesem Member können eine beliebige sinnvolle Kombination der folgenden Werte sein.

Die Bitflags, die die Maustaste status angeben, sind so festgelegt, dass änderungen in status und nicht auf laufende Bedingungen angegeben werden. Wenn beispielsweise die linke Maustaste gedrückt und gedrückt gehalten wird, wird MOUSEEVENTF_LEFTDOWN festgelegt, wenn die linke Taste zuerst gedrückt wird, aber nicht für nachfolgende Bewegungen. Auf ähnliche Weise wird MOUSEEVENTF_LEFTUP nur festgelegt, wenn die Schaltfläche zum ersten Mal freigegeben wird.

Sie können nicht sowohl das MOUSEEVENTF_WHEEL-Flag als auch MOUSEEVENTF_XDOWN- oder MOUSEEVENTF_XUP-Flags gleichzeitig im dwFlags-Parameter angeben, da beide das MouseData-Feld verwenden müssen.

Wert Bedeutung
MOUSEEVENTF_MOVE
0x0001		 Es ist eine Bewegung aufgetreten.
MOUSEEVENTF_LEFTDOWN
0x0002		 Die linke Schaltfläche wurde gedrückt.
MOUSEEVENTF_LEFTUP
0x0004		 Die linke Schaltfläche wurde freigegeben.
MOUSEEVENTF_RIGHTDOWN
0x0008		 Die rechte Taste wurde gedrückt.
MOUSEEVENTF_RIGHTUP
0x0010		 Die rechte Schaltfläche wurde freigegeben.
MOUSEEVENTF_MIDDLEDOWN
0x0020		 Die mittlere Taste wurde gedrückt.
MOUSEEVENTF_MIDDLEUP
0x0040		 Die mittlere Schaltfläche wurde freigegeben.
MOUSEEVENTF_XDOWN
0x0080		 Eine X-Taste wurde gedrückt.
MOUSEEVENTF_XUP
0x0100		 Eine X-Schaltfläche wurde freigegeben.
MOUSEEVENTF_WHEEL
0x0800		 Das Rad wurde bewegt, wenn die Maus ein Rad hat. Der Bewegungsumfang wird in mouseData angegeben.
MOUSEEVENTF_HWHEEL
0x1000		 Das Rad wurde horizontal bewegt, wenn die Maus über ein Rad verfügt. Der Bewegungsumfang wird in mouseData angegeben.
Windows XP/2000: Dieser Wert wird nicht unterstützt.
MOUSEEVENTF_MOVE_NOCOALESCE
0x2000		 Die WM_MOUSEMOVE Nachrichten werden nicht vereint. Das Standardverhalten besteht darin, WM_MOUSEMOVE Nachrichten zusammenzuverknen.
Windows XP/2000: Dieser Wert wird nicht unterstützt.
MOUSEEVENTF_VIRTUALDESK
0x4000		 Ordnet Koordinaten dem gesamten Desktop zu. Muss mit MOUSEEVENTF_ABSOLUTE verwendet werden.
MOUSEEVENTF_ABSOLUTE
0x8000		 Die Elemente dx und dy enthalten normalisierte absolute Koordinaten. Wenn das Flag nicht festgelegt ist, enthalten dxund dy relative Daten (die Änderung der Position seit der letzten gemeldeten Position). Dieses Flag kann festgelegt oder nicht festgelegt werden, unabhängig davon, welche Art von Maus oder ein anderes zeigendes Gerät (falls vorhanden) mit dem System verbunden ist. Weitere Informationen zur relativen Mausbewegung finden Sie im abschnitt Hinweise.

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.

Hinweise

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

Wenn MOUSEEVENTF_ABSOLUTE Wert angegeben wird, enthalten dx und dy normalisierte absolute Koordinaten zwischen 0 und 65.535. Die Ereignisprozedur ordnet diese Koordinaten der Anzeigeoberfläche zu. Koordinatenkarten (0,0) auf der oberen linken Ecke der Anzeigeoberfläche; Koordinaten (65535,65535) karten auf der unteren rechten Ecke. 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 MOUSEEVENTF_ABSOLUTE Wert nicht angegeben wird, geben dxund dy die Bewegung relativ zum vorherigen Mausereignis (die zuletzt gemeldete Position) an. Positive Werte bedeuten, dass die Maus nach rechts (oder nach unten) verschoben wurde. negative Werte bedeuten, dass die Maus nach links (oder nach oben) verschoben wurde.

Die relative Mausbewegung unterliegt den Auswirkungen der Mausgeschwindigkeit und der Schwellenwerte für zwei Mausen. Ein Benutzer legt diese drei Werte mit dem Schieberegler Zeigergeschwindigkeit des Blatts Mauseigenschaften des Systemsteuerung fest. Sie können diese Werte mit 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 Schwellenwert der ersten Maus ist und die Mausgeschwindigkeit nicht 0 ist, verdoppelt das System den Abstand. Wenn der angegebene Abstand entlang der x- oder y-Achse größer als der schwellenwert für die zweite Maus ist und die Mausgeschwindigkeit gleich zwei ist, verdoppelt das System den Abstand, der sich aus der Anwendung des ersten Schwellenwerttests ergibt. So ist es dem System möglich, die angegebene relative Mausbewegung entlang der x- oder y-Achse bis zu viermal zu multiplizieren.

Anforderungen

   
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)

Siehe auch

Konzept

GetMessageExtraInfo

INPUT

Tastatureingabe

Referenz

SendInput