struktur KEY_EVENT_RECORD

Artikel
12/13/2023

Menjelaskan peristiwa input keyboard di konsol INPUT_RECORD struktur.

Sintaks

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

Anggota

bKeyDown
Jika tombol ditekan, anggota ini ADALAH TRUE. Jika tidak, anggota ini adalah FALSE (kunci dirilis).

wRepeatCount
Jumlah pengulangan, yang menunjukkan bahwa kunci sedang ditahan. Misalnya, ketika kunci ditahan, Anda mungkin mendapatkan lima peristiwa dengan anggota ini sama dengan 1, satu acara dengan anggota ini sama dengan 5, atau beberapa peristiwa dengan anggota ini lebih besar dari atau sama dengan 1.

wVirtualKeyCode
Kode kunci virtual yang mengidentifikasi kunci yang diberikan dengan cara yang independen perangkat.

wVirtualScanCode
Kode pemindaian virtual dari kunci yang diberikan yang mewakili nilai yang bergantung pada perangkat yang dihasilkan oleh perangkat keras keyboard.

uChar
Serikat anggota berikut.

UnicodeChar
Karakter Unicode yang diterjemahkan.

AsciiChar
Karakter ASCII yang diterjemahkan.

dwControlKeyState
Status kunci kontrol. Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Value	Makna
CAPSLOCK_ON 0x0080	Lampu CAPS LOCK menyala.
ENHANCED_KEY 0x0100	Kunci ditingkatkan. Lihat komentar.
0x0002 LEFT_ALT_PRESSED	Tombol ALT kiri ditekan.
0x0008 LEFT_CTRL_PRESSED	Tombol CTRL kiri ditekan.
0x0020 NUMLOCK_ON	Lampu NUM LOCK menyala.
0x0001 RIGHT_ALT_PRESSED	Tombol ALT kanan ditekan.
0x0004 RIGHT_CTRL_PRESSED	Tombol CTRL kanan ditekan.
0x0040 SCROLLLOCK_ON	Lampu SCROLL LOCK menyala.
0x0010 SHIFT_PRESSED	Tombol SHIFT ditekan.

Keterangan

Kunci yang disempurnakan untuk keyboard IBM® 101- dan 102-key adalah tombol INS, DEL, HOME, END, PAGE UP, PAGE DOWN, dan arah di kluster di sebelah kiri keypad; dan tombol bagi (/) dan ENTER di keypad.

Peristiwa input keyboard dihasilkan ketika tombol apa pun, termasuk tombol kontrol, ditekan atau dilepaskan. Namun, tombol ALT ketika ditekan dan dirilis tanpa menggabungkan dengan karakter lain, memiliki arti khusus untuk sistem dan tidak diteruskan ke aplikasi. Selain itu, kombinasi tombol CTRL+C tidak diteruskan jika handel input dalam mode yang diproses (ENABLE_PROCESSED_INPUT).

Contoh

Misalnya, lihat Membaca Peristiwa Buffer Input.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	WinConTypes.h (melalui WinCon.h, termasuk Windows.h)

Bagikan melalui