Bagikan melalui


Menggunakan Peristiwa Keyboard

Sebagian besar program Formulir Windows memproses input keyboard dengan menangani peristiwa keyboard. Topik ini memberikan gambaran umum tentang peristiwa keyboard, termasuk detail tentang kapan harus menggunakan setiap peristiwa dan data yang disediakan untuk setiap peristiwa. Lihat Juga Gambaran Umum Penanganan Aktivitas (Formulir Windows) dan Gambaran Umum Peristiwa (Formulir Windows).

Peristiwa Keyboard

Formulir Windows menyediakan dua peristiwa yang terjadi saat pengguna menekan tombol keyboard dan satu peristiwa saat pengguna merilis tombol keyboard:

  • Peristiwa KeyDown terjadi sekali

  • Peristiwa, KeyPress yang dapat terjadi beberapa kali ketika pengguna menahan kunci yang sama.

  • Peristiwa terjadi KeyUp sekali ketika pengguna merilis kunci.

Saat pengguna menekan tombol, Formulir Windows menentukan peristiwa mana yang akan dinaikkan berdasarkan apakah pesan keyboard menentukan kunci karakter atau kunci fisik. Untuk informasi selengkapnya tentang karakter dan tombol fisik, lihat Cara Kerja Input Keyboard.

Tabel berikut ini menjelaskan tiga peristiwa keyboard.

Peristiwa keyboard Deskripsi Hasil
KeyDown Kejadian ini dimunculkan ketika pengguna menekan kunci fisik. Handler untuk KeyDown menerima:

  • Parameter KeyEventArgs , yang menyediakan KeyCode properti (yang menentukan tombol keyboard fisik).
  • Properti Modifiers (SHIFT, CTRL, atau ALT).
  • Properti KeyData (yang menggabungkan kode kunci dan pengubah). Parameter ini KeyEventArgs juga menyediakan:

    • Properti Handled , yang dapat diatur untuk mencegah kontrol yang mendasar menerima kunci.
    • PropertiSuppressKeyPress, yang dapat digunakan untuk menekan peristiwa dan KeyUp untuk penekanan tombol tersebutKeyPress.
KeyPress Kejadian ini dinaikkan ketika tombol atau tombol yang ditekan menghasilkan karakter. Misalnya, pengguna menekan SHIFT dan tombol "a" huruf kecil, yang menghasilkan huruf kapital "A" karakter. KeyPress dimunculkan setelah KeyDown.

  • Handler untuk KeyPress menerima:
  • Parameter KeyPressEventArgs , yang berisi kode karakter tombol yang ditekan. Kode karakter ini unik untuk setiap kombinasi kunci karakter dan kunci pengubah.

    Misalnya, kunci "A" akan menghasilkan:

    • Kode karakter 65, jika ditekan dengan tombol SHIFT
    • Atau tombol CAPS LOCK, 97 jika ditekan dengan sendirinya,
    • Dan 1, jika ditekan dengan tombol CTRL.
KeyUp Kejadian ini dimunculkan saat pengguna merilis kunci fisik. Handler untuk KeyUp menerima:

  • Parameter KeyEventArgs :

    • Yang menyediakan KeyCode properti (yang menentukan tombol keyboard fisik).
    • Properti Modifiers (SHIFT, CTRL, atau ALT).
    • Properti KeyData (yang menggabungkan kode kunci dan pengubah).

Baca juga