Udostępnij przez


struktura KEY_EVENT_RECORD

Opisuje zdarzenie wejściowe klawiatury w strukturze INPUT_RECORD konsoli.

Składnia

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

Członkowie

bKeyDown
Jeśli zostanie naciśnięty, ten element członkowski ma wartość TRUE. W przeciwnym razie ten element członkowski ma wartość FALSE (klucz jest zwalniany).

wRepeatCount
Liczba powtórzeń, która wskazuje, że klucz jest przytrzymywany. Na przykład po zatrzymaniu klucza może zostać wyświetlonych pięć zdarzeń z tym elementem członkowskim równym 1, jedno zdarzenie z tym elementem członkowskim równe 5 lub wiele zdarzeń z tym elementem członkowskim większym lub równym 1.

wVirtualKeyCode
Kod klucza wirtualnego, który identyfikuje dany klucz w sposób niezależny od urządzenia.

wVirtualScanCode
Kod skanowania wirtualnego danego klucza, który reprezentuje wartość zależną od urządzenia wygenerowaną przez sprzęt klawiatury.

uChar
Związek następujących członków.

UnicodeChar
Przetłumaczony znak Unicode.

AsciiChar
Przetłumaczony znak ASCII.

dwControlKeyState
Stan kluczy sterujących. Ten element członkowski może być co najmniej jedną z następujących wartości.

Wartość Znaczenie
CAPSLOCK_ON 0x0080 Dioda CAPS LOCK jest włączona.
ENHANCED_KEY 0x0100 Klucz jest rozszerzony. Zobacz uwagi.
LEFT_ALT_PRESSED 0x0002 Lewy ALT jest naciskany.
LEFT_CTRL_PRESSED 0x0008 Naciśnij lewy CTRL.
NUMLOCK_ON 0x0020 Dioda NUM LOCK jest włączona.
RIGHT_ALT_PRESSED 0x0001 Naciskany jest prawy ALT.
RIGHT_CTRL_PRESSED 0x0004 Naciśnięcie prawego CTRL.
SCROLLLOCK_ON 0x0040 Kontrolka SCROLL LOCK jest włączona.
SHIFT_PRESSED 0x0010 Naciśnięcie SHIFT.

Uwagi

Ulepszone dla klawiatur IBM® 101- i 102-klawiszowych to INS, DEL, HOME, END, PAGE UP, PAGE DOWN i kierunkowe w klastrach po lewej stronie klawiatury; oraz divide (/) i ENTER w klawiaturze.

Zdarzenia wprowadzania klawiatury są generowane, gdy dowolny, w tym sterowania, jest naciskany lub zwalniany. Jednak ALT po naciśnięciu i zwolnieniu bez połączenia z innym znakiem ma specjalne znaczenie dla systemu i nie jest przekazywany do aplikacji. Ponadto kombinacja CTRL+C nie jest przekazywana, jeśli uchwyt wejściowy jest w trybie przetwarzania (ENABLE_PROCESSED_INPUT).

Przykłady

Aby zapoznać się z przykładem, zobacz Odczytywanie zdarzeń buforu wejściowego.

Wymagania

   
Minimalny obsługiwany klient Windows 2000 Professional [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer Windows 2000 Server [tylko aplikacje klasyczne]
Nagłówek WinConTypes.h (za pośrednictwem pliku WinCon.h, include Windows.h)

Zobacz także

PeekConsoleInput

ReadConsoleInput

WriteConsoleInput

INPUT_RECORD