KEY_EVENT_RECORD structuur

Beschrijft een toetsenbordinvoer gebeurtenis in een console INPUT_RECORD structuur.

Syntaxis

typedef struct _KEY_EVENT_RECORD {
  BOOL  bKeyDown;
  WORD  wRepeatCount;
  WORD  wVirtualKeyCode;
  WORD  wVirtualScanCode;
  union {
    WCHAR UnicodeChar;
    CHAR  AsciiChar;
  } uChar;
  DWORD dwControlKeyState;
} KEY_EVENT_RECORD;

Leden

bKeyDown
Als de toets wordt ingedrukt, is dit lid WAAR. Anders is dit lid ONWAAR (de sleutel wordt vrijgegeven).

wRepeatCount
Het aantal herhalingen, wat aangeeft dat een sleutel wordt vastgehouden. Als een sleutel bijvoorbeeld wordt ingedrukt, krijgt u mogelijk vijf gebeurtenissen met dit lid gelijk aan 1, één gebeurtenis met dit lid gelijk aan 5 of meerdere gebeurtenissen met dit lid groter dan of gelijk aan 1.

wVirtualKeyCode
Een code van een virtuele sleutel die de opgegeven sleutel op een apparaatonafhankelijke manier identificeert.

wVirtualScanCode
De virtuele scancode van de opgegeven sleutel die de apparaatafhankelijke waarde vertegenwoordigt die wordt gegenereerd door de toetsenbordhardware.

uChar
Een vereniging van de volgende leden.

UnicodeChar
Vertaald Unicode-teken.

AsciiChar
Vertaald ASCII-teken.

dwControlKeyState
De status van de besturingssleutels. Dit lid kan een of meer van de volgende waarden zijn.

Waarde	Betekenis
CAPSLOCK_ON 0x0080	Het CAPS LOCK-licht is ingeschakeld.
ENHANCED_KEY 0x0100	De sleutel is verbeterd. Zie opmerkingen.
LEFT_ALT_PRESSED 0x0002	De linker Alt-toets wordt ingedrukt.
LEFT_CTRL_PRESSED 0x0008	De ctrl-toets links wordt ingedrukt.
NUMLOCK_ON 0x0020	Het NUM LOCK-licht is ingeschakeld.
RIGHT_ALT_PRESSED 0x0001	De rechter Alt-toets wordt ingedrukt.
RIGHT_CTRL_PRESSED 0x0004	De ctrl-toets rechts wordt ingedrukt.
SCROLLLOCK_ON 0x0040	Het SCROLL LOCK-licht is ingeschakeld.
SHIFT_PRESSED 0x0010	De SHIFT-toets wordt ingedrukt.

Opmerkingen

Verbeterde toetsen voor de IBM® 101- en 102-toetstoetsen zijn de INS-, DEL-, HOME-, END-, PAGE UP-, PAGE DOWN- en richtingtoetsen in de clusters links van het toetsenblok; en de toetsen delen (/) en ENTER in het toetsenblok.

Er worden toetsenbordinvoergebeurtenissen gegenereerd wanneer een toets, inclusief besturingstoetsen, wordt ingedrukt of vrijgegeven. De Alt-toets die wordt ingedrukt en losgelaten zonder te combineren met een ander teken, heeft echter een speciale betekenis voor het systeem en wordt niet doorgegeven aan de toepassing. De toetsencombinatie Ctrl+C wordt ook niet doorgegeven als de invoergreep zich in de verwerkte modus bevindt (ENABLE_PROCESSED_INPUT).

Voorbeelden

Zie Voorbeeld : Gebeurtenissen van invoerbuffer lezen.

Behoeften

Minimaal ondersteunde client	Windows 2000 Professional [alleen desktop-apps]
Minimaal ondersteunde server	Windows 2000 Server [alleen desktop-apps]
Koptekst	WinConTypes.h (via WinCon.h, inclusief Windows.h)

Zie ook

PeekConsoleInput

ReadConsoleInput

WriteConsoleInput

INPUT_RECORD