Fungsi GetKeyboardLayout (winuser.h)

Artikel
03/13/2024

Mengambil pengidentifikasi lokal input aktif (sebelumnya disebut tata letak keyboard).

Sintaks

HKL GetKeyboardLayout(
  [in] DWORD idThread
);

Parameter

[in] idThread

Jenis: DWORD

Pengidentifikasi utas yang akan dikueri, atau 0 untuk utas saat ini.

Nilai kembali

Jenis: HKL

Nilai yang dikembalikan adalah pengidentifikasi lokal input untuk utas. Kata rendah berisi Pengidentifikasi Bahasa untuk bahasa input dan kata tinggi berisi handel perangkat ke tata letak fisik keyboard.

Keterangan

Pengidentifikasi lokal input adalah konsep yang lebih luas daripada tata letak keyboard, karena juga dapat mencakup pengonversi ucapan ke teks, Metode Input Editor (IME), atau bentuk input lainnya.

Karena tata letak keyboard dapat diubah secara dinamis, aplikasi yang menyimpan informasi tentang tata letak keyboard saat ini harus memproses pesan WM_INPUTLANGCHANGE untuk diberi tahu tentang perubahan dalam bahasa input.

Untuk mendapatkan KLID (ID tata letak keyboard) dari HKL yang saat ini aktif, panggil GetKeyboardLayoutName.

Dimulai di Windows 8: Metode yang disukai untuk mengambil bahasa yang terkait dengan tata letak keyboard saat ini atau metode input adalah panggilan ke Windows.Globalization.Language.CurrentInputMethodLanguageTag. Jika aplikasi Anda meneruskan tag bahasa dari CurrentInputMethodLanguageTag ke fungsi Dukungan Bahasa Nasional apa pun, aplikasi harus terlebih dahulu mengonversi tag dengan memanggil ResolveLocaleName.

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 (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll