INPUT_RECORD-Struktur

Artikel
12/21/2023

Beschreibt ein Eingabeereignis im Konsoleneingabepuffer. Diese Datensätze können mithilfe der ReadConsoleInput- oder PeekConsoleInput-Funktion aus dem Eingabepuffer gelesen oder mithilfe der WriteConsoleInput-Funktion in den Eingabepuffer geschrieben werden.

Syntax

typedef struct _INPUT_RECORD {
  WORD  EventType;
  union {
    KEY_EVENT_RECORD          KeyEvent;
    MOUSE_EVENT_RECORD        MouseEvent;
    WINDOW_BUFFER_SIZE_RECORD WindowBufferSizeEvent;
    MENU_EVENT_RECORD         MenuEvent;
    FOCUS_EVENT_RECORD        FocusEvent;
  } Event;
} INPUT_RECORD;

Member

EventType
Ein Handle für den Typ des Eingabeereignisses und den Ereignisdatensatz, der im Ereigniselement gespeichert ist.

Der Member kann einer der folgenden Werte sein.

Wert	Bedeutung
FOCUS_EVENT 0x0010	Das Ereigniselement enthält eine FOCUS_EVENT_RECORD Struktur. Diese Ereignisse werden intern verwendet und sollten ignoriert werden.
KEY_EVENT 0x0001	Das Ereigniselement enthält eine KEY_EVENT_RECORD Struktur mit Informationen zu einem Tastaturereignis.
MENU_EVENT 0x0008	Das Ereigniselement enthält eine MENU_EVENT_RECORD Struktur. Diese Ereignisse werden intern verwendet und sollten ignoriert werden.
MOUSE_EVENT 0x0002	Das Ereigniselement enthält eine MOUSE_EVENT_RECORD Struktur mit Informationen zu einer Mausbewegung oder einem Tastendruckereignis.
WINDOW_BUFFER_SIZE_EVENT 0x0004	Das Ereigniselement enthält eine WINDOW_BUFFER_SIZE_RECORD Struktur mit Informationen zur neuen Größe des Konsolenbildschirmpuffers.

Event
Die Ereignisinformationen. Das Format dieses Elements hängt vom dem EventType ab, das vomEventType Element angegebenen ist.

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)