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)

Siehe auch

PeekConsoleInput

ReadConsoleInput

WriteConsoleInput

INPUT_RECORD