Fungsi GetKeyState (winuser.h)

Mengambil status kunci virtual yang ditentukan. Status menentukan apakah tombol naik, turun, atau beralih (aktif, nonaktif—bergantian setiap kali tombol ditekan).

Syntax

SHORT GetKeyState(
  [in] int nVirtKey
);

Parameter-parameternya

[in] nVirtKey

Jenis: int

Kunci virtual. Jika kunci virtual yang diinginkan adalah huruf atau digit (A hingga Z, hingga z, atau 0 hingga 9), nVirtKey harus diatur ke nilai ASCII karakter tersebut. Untuk kunci lain, itu harus berupa kode kunci virtual.

Jika tata letak keyboard non-Bahasa Inggris digunakan, tombol virtual dengan nilai dalam rentang ASCII A hingga Z dan 0 hingga 9 digunakan untuk menentukan sebagian besar kunci karakter. Misalnya, untuk tata letak keyboard Jerman, kunci virtual nilai ASCII O (0x4F) mengacu pada kunci "o", sedangkan VK_OEM_1 mengacu pada kunci "o dengan umlaut".

Mengembalikan nilai

Jenis: PENDEK

Nilai pengembalian menentukan status kunci virtual yang ditentukan, sebagai berikut:

  • Jika bit berurutan tinggi adalah 1, kuncinya tidak berfungsi; jika tidak, itu terserah.
  • Jika bit berurutan rendah adalah 1, kunci akan diaktifkan. Kunci, seperti kunci CAPS LOCK, diaktifkan jika diaktifkan. Kunci tidak aktif dan tidak tersentuh jika bit urutan rendah adalah 0. Lampu indikator tombol toggle (jika ada) pada keyboard akan menyala saat tombol diaktifkan, dan mati saat tombol tidak disentuh.

Komentar

Status kunci yang dikembalikan dari fungsi ini berubah saat utas membaca pesan kunci dari antrean pesannya. Status tidak mencerminkan status tingkat interupsi yang terkait dengan perangkat keras. Gunakan fungsi GetAsyncKeyState untuk mengambil informasi tersebut.

Aplikasi memanggil GetKeyState sebagai respons terhadap pesan input keyboard. Fungsi ini mengambil status kunci saat pesan input dibuat.

Untuk mengambil informasi status untuk semua kunci virtual, gunakan fungsi GetKeyboardState .

Aplikasi dapat menggunakan konstanta kode kunci virtualVK_SHIFT, VK_CONTROL, dan VK_MENU sebagai nilai untuk parameter nVirtKey . Ini memberikan status tombol SHIFT, CTRL, atau ALT tanpa membedakan antara kiri dan kanan. Aplikasi juga dapat menggunakan konstanta kode kunci virtual berikut sebagai nilai untuk nVirtKey untuk membedakan antara instans kiri dan kanan kunci tersebut:

VK_LSHIFTVK_RSHIFTVK_LCONTROLVK_RCONTROLVK_LMENUVK_RMENU Konstanta kiri dan kanan ini tersedia untuk aplikasi hanya melalui fungsi GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyState, dan MapVirtualKey .

Examples

Misalnya, lihat Menampilkan Input Keyboard.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Platform Target Windows
Header winuser.h (termasuk Windows.h)
Library User32.lib
DLL User32.dll

Lihat juga

  • Last updated on