Fungsi VkKeyScanA (winuser.h)

  • Artikel

[Fungsi ini telah digantikan oleh fungsi VkKeyScanEx . Namun, Anda masih bisa menggunakan VkKeyScan, jika Anda tak perlu menentukan tata letak kibor.]

Menerjemahkan karakter ke kode kunci virtual yang sesuai dan mengalihkan status untuk keyboard saat ini.

Sintaks

SHORT VkKeyScanA(
  [in] CHAR ch
);

Parameter

[in] ch

Jenis: TCHAR

Karakter yang akan diterjemahkan ke dalam kode kunci virtual.

Nilai kembali

Jenis: PENDEK

Jika fungsi berhasil, byte urutan rendah dari nilai yang dikembalikan berisi kode kunci virtual dan byte urutan tinggi berisi status shift, yang dapat menjadi kombinasi dari bit bendera berikut.

Mengembalikan nilai Deskripsi
1
 Salah satu tombol SHIFT ditekan.
2
 Salah satu tombol CTRL ditekan.
4
 Salah satu tombol ALT ditekan.
8
 Tombol Hankaku ditekan
16
 Dicadangkan (ditentukan oleh driver tata letak keyboard).
32
 Dicadangkan (ditentukan oleh driver tata letak keyboard).
 

Jika fungsi tidak menemukan kunci yang diterjemahkan ke kode karakter yang diteruskan, byte urutan rendah dan urutan tinggi berisi –1.

Keterangan

Untuk tata letak keyboard yang menggunakan tombol ALT sebelah kanan sebagai tombol shift (misalnya, tata letak keyboard Prancis), status shift diwakili oleh nilai 6, karena tombol ALT sebelah kanan dikonversi secara internal menjadi CTRL+ALT.

Terjemahan untuk keypad numerik (VK_NUMPAD0 melalui VK_DIVIDE) diabaikan. Fungsi ini dimaksudkan untuk menerjemahkan karakter ke dalam penekanan tombol dari bagian keyboard utama saja. Misalnya, karakter "7" diterjemahkan ke dalam VK_7, bukan VK_NUMPAD7.

VkKeyScan digunakan oleh aplikasi yang mengirim karakter dengan menggunakan pesan WM_KEYUP dan WM_KEYDOWN .

Catatan

Header winuser.h mendefinisikan VkKeyScan sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Lihat juga