KEY_EVENT_RECORD-Struktur
Beschreibt ein Tastatureingabeereignis in einer Konsole INPUT_RECORD Struktur.
Syntax
typedef struct _KEY_EVENT_RECORD {
BOOL bKeyDown;
WORD wRepeatCount;
WORD wVirtualKeyCode;
WORD wVirtualScanCode;
union {
WCHAR UnicodeChar;
CHAR AsciiChar;
} uChar;
DWORD dwControlKeyState;
} KEY_EVENT_RECORD;
Member
bKeyDown
Wenn die Taste gedrückt wird, ist dieses Element WAHR. Andernfalls ist dieses Element FALSE (der Schlüssel wird losgelassen).
wRepeatCount
Die Wiederholungsanzahl, die angibt, dass eine Taste gedrückt gehalten wird. Wenn beispielsweise eine Taste gedrückt gehalten wird, erhalten Sie möglicherweise fünf Ereignisse mit diesem Element gleich 1, ein Ereignis mit diesem Element gleich 5 oder mehrere Ereignisse mit diesem Element größer oder gleich 1.
wVirtualKeyCode
Ein virtueller Schlüsselcode , der den angegebenen Schlüssel auf geräteunabhängige Weise identifiziert.
wVirtualScanCode
Der virtuelle Scancode des angegebenen Schlüssels, der den geräteabhängigen Wert darstellt, der von der Tastaturhardware generiert wird.
uChar
Eine Vereinigung der folgenden Mitglieder.
UnicodeChar
Übersetztes Unicode-Zeichen.
AsciiChar
Übersetztes ASCII-Zeichen.
dwControlKeyState
Speichert den Zustand des Steuerelements. Dies kann einen der folgenden Werte annehmen.
| Wert | Bedeutung |
|---|---|
| CAPSLOCK_ON 0x0080 | Das Licht 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 Leuchte der BILDLAUFSPERRE ist aktiviert. |
| SHIFT_PRESSED 0x0010 | Die UMSCHALTTASTE wird gedrückt. |
Hinweise
Erweiterte Tasten für die Tasten IBM® 101- und 102-Tasten sind die TASTEN INS, DEL, HOME, ENDE, BILD-AUF- und BILD-AB und Richtungstasten in den Clustern links neben der Wähltastatur; und die Trenntasten (/) und DIE EINGABETASTE auf der Wähltastatur.
Tastatureingabeereignisse werden generiert, wenn eine beliebige Taste, einschließlich der Steuertasten, gedrückt oder losgelassen wird. Die ALT-TASTE, wenn sie gedrückt und losgelassen wird, ohne es mit einem anderen Zeichen zu kombinieren, hat jedoch eine besondere Bedeutung für das System und wird nicht an die Anwendung übergeben. Außerdem wird die TASTENkombination STRG+C nicht durchlaufen, wenn sich der Eingabepunkt im verarbeiteten Modus befindet (ENABLE_PROCESSED_INPUT).
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) |