MOUSE_EVENT_RECORD-Struktur
Wichtig
In diesem Dokument werden Konsolenplattformfunktionen beschrieben, die nicht mehr Teil unserer Ökosystem-Roadmap sind. Wir empfehlen nicht, diesen Inhalt in neuen Produkten zu verwenden, aber wir werden weiterhin vorhandene Nutzungen für die unbegrenzte Zukunft unterstützen. Unsere bevorzugte moderne Lösung konzentriert sich auf virtuelle Terminalsequenzen für maximale Kompatibilität in plattformübergreifenden Szenarien. Weitere Informationen zu dieser Designentscheidung finden Sie in unserem klassischen Konsolendokument im Vergleich zum virtuellen Terminal .
Beschreibt ein Mauseingabeereignis in einer Konsole INPUT_RECORD Struktur.
Syntax
typedef struct _MOUSE_EVENT_RECORD {
COORD dwMousePosition;
DWORD dwButtonState;
DWORD dwControlKeyState;
DWORD dwEventFlags;
} MOUSE_EVENT_RECORD;
Member
dwMousePosition
Eine COORD-Struktur , die die Position des Cursors in Bezug auf die Zeichenzellenkoordinaten des Konsolenbildschirmpuffers enthält.
dwButtonState
Der Zustand der Maustasten. Das am wenigsten signifikante Bit entspricht der äußerst linken Maustaste. Das nächste am wenigsten signifikante Bit entspricht der äußerst rechten Maustaste. Das nächste Bit zeigt die äußerst linke Maustaste an. Die Bits entsprechen dann von links nach rechts den Maustasten. Ein Bit ist 1, wenn die Taste gedrückt wurde.
Die folgenden Konstanten werden für die ersten fünf Maustasten definiert.
| Wert | Bedeutung |
|---|---|
| FROM_LEFT_1ST_BUTTON_PRESSED 0x0001 | Die äußerst linke Maustaste. |
| FROM_LEFT_2ND_BUTTON_PRESSED 0x0004 | Die zweite Schaltfläche von links. |
| FROM_LEFT_3RD_BUTTON_PRESSED 0x0008 | Die dritte Schaltfläche von links. |
| FROM_LEFT_4TH_BUTTON_PRESSED 0x0010 | Die vierte Schaltfläche von links. |
| RIGHTMOST_BUTTON_PRESSED 0x0002 | Die äußerst rechte Maustaste. |
dwControlKeyState
Zustand des -Steuerelements. Dies kann einen der folgenden Werte annehmen:
| Wert | Bedeutung |
|---|---|
| CAPSLOCK_ON 0x0080 | Die Beleuchtung der FESTSTELLTASTE ist eingeschaltet. |
| ENHANCED_KEY 0x0100 | Der Schlüssel wird erweitert. Siehe Bemerkungen. |
| LEFT_ALT_PRESSED 0x0002 | Die linke ALT-TASTE wird gedrückt. |
| LEFT_CTRL_PRESSED 0x0008 | Die linke STRG-TASTE wird gedrückt. |
| NUMLOCK_ON 0x0020 | Die NUM-SPERRleuchte ist aktiviert. |
| RIGHT_ALT_PRESSED 0x0001 | Die rechte ALT-TASTE wird gedrückt. |
| RIGHT_CTRL_PRESSED 0x0004 | Die rechte STRG-TASTE wird gedrückt. |
| SCROLLLOCK_ON 0x0040 | Die Beleuchtung der BILDLAUFSPERRE ist aktiviert. |
| SHIFT_PRESSED 0x0010 | Die UMSCHALTTASTE wird gedrückt. |
dwEventFlags
Die Art des Mausereignisses Wenn dieser Wert null ist, wird eine Maustaste angezeigt, die gedrückt oder losgelassen wird. Andernfalls ist dieses Element einer der folgenden Werte.
| Wert | Bedeutung |
|---|---|
| DOUBLE_CLICK 0x0002 | Der zweite Klick (Tastendruck) eines Doppelklicks ist aufgetreten. Der erste Klick wird als normales Button-Press-Ereignis zurückgegeben. |
| MOUSE_HWHEELED 0x0008 | Das horizontale Mausrad wurde verschoben. Wenn das hohe Wort des dwButtonState-Elements einen positiven Wert enthält, wurde das Rad nach rechts gedreht. Andernfalls wurde das Rad nach links gedreht. |
| MOUSE_MOVED 0x0001 | Eine Änderung der Mausposition ist aufgetreten. |
| MOUSE_WHEELED 0x0004 | Das vertikale Mausrad wurde verschoben. Wenn das hohe Wort des dwButtonState-Elements einen positiven Wert enthält, wurde das Rad vorwärts gedreht, weg vom Benutzer. Andernfalls wurde das Rad rückwärts in Richtung des Benutzers gedreht. |
Hinweise
Mausereignisse werden im Eingabepuffer platziert, wenn sich die Konsole im Mausmodus befindet (ENABLE_MOUSE_INPUT).
Mausereignisse werden generiert, wenn der Benutzer die Maus bewegt oder eine der Maustasten drückt oder loslässt. Mausereignisse werden nur dann im Eingabepuffer einer Konsole platziert, wenn die Konsolengruppe den Tastaturfokus hat und sich der Cursor innerhalb der Rahmen des Konsolenfensters befindet.
Beispiele
Ein Beispiel finden Sie unter Lesen von Eingabepufferereignissen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Header | ConsoleApi.h (über WinCon.h, Windows.h einschließen) |
Siehe auch
COORD