Fungsi ActivateKeyboardLayout (winuser.h)

Artikel
08/27/2023

Mengatur pengidentifikasi lokal input (sebelumnya disebut handel tata letak keyboard) untuk utas panggilan atau proses saat ini. Pengidentifikasi lokal input menentukan lokal serta tata letak fisik keyboard.

Sintaks

HKL ActivateKeyboardLayout(
  [in] HKL  hkl,
  [in] UINT Flags
);

Parameter

[in] hkl

Jenis: HKL

Masukkan pengidentifikasi lokal untuk diaktifkan.

Pengidentifikasi lokal input harus telah dimuat oleh panggilan sebelumnya ke fungsi LoadKeyboardLayout . Parameter ini harus berupa handel ke tata letak keyboard atau salah satu nilai berikut.

Nilai	Makna
HKL_NEXT 1	Memilih pengidentifikasi lokal berikutnya dalam daftar melingkar pengidentifikasi lokal yang dimuat yang dikelola oleh sistem.
HKL_PREV 0	Memilih pengidentifikasi lokal sebelumnya dalam daftar melingkar pengidentifikasi lokal yang dimuat yang dikelola oleh sistem.

[in] Flags

Jenis: UINT

Menentukan bagaimana pengidentifikasi lokal input akan diaktifkan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
KLF_REORDER 0x00000008	Jika bit ini diatur, daftar melingkar sistem dari pengidentifikasi lokal yang dimuat disusun ulang dengan memindahkan pengidentifikasi lokal ke kepala daftar. Jika bit ini tidak diatur, daftar diputar tanpa perubahan urutan. Misalnya, jika pengguna memiliki pengidentifikasi lokal Bahasa Inggris aktif, serta memiliki pengidentifikasi lokal Prancis, Jerman, dan Spanyol yang dimuat (dalam urutan tersebut), maka mengaktifkan pengidentifikasi lokal Jerman dengan set bit KLF_REORDER akan menghasilkan urutan berikut: Jerman, Inggris, Prancis, Spanyol. Mengaktifkan pengidentifikasi lokal Jerman tanpa set bit KLF_REORDER akan menghasilkan urutan berikut: Jerman, Spanyol, Inggris, Prancis. Jika kurang dari tiga pengidentifikasi lokal dimuat, nilai bendera ini tidak relevan.
KLF_RESET 0x40000000	Jika diatur tetapi KLF_SHIFTLOCK tidak diatur, status Caps Lock dimatikan dengan menekan tombol Caps Lock lagi. Jika diatur dan KLF_SHIFTLOCK juga diatur, status Caps Lock dimatikan dengan menekan salah satu tombol SHIFT. Kedua metode ini saling eksklusif, dan pengaturan tetap ada sebagai bagian dari profil Pengguna di registri.
KLF_SETFORPROCESS 0x00000100	Mengaktifkan pengidentifikasi lokal yang ditentukan untuk seluruh proses dan mengirim pesan WM_INPUTLANGCHANGE ke fokus utas saat ini atau jendela aktif.
KLF_SHIFTLOCK 0x00010000	Ini digunakan dengan KLF_RESET. Lihat KLF_RESET untuk penjelasannya.
KLF_UNLOADPREVIOUS	Bendera ini tidak didukung. Gunakan fungsi UnloadKeyboardLayout sebagai gantinya.

Nilai kembali

Jenis: HKL

Nilai yang dikembalikan berjenis HKL. Jika fungsi berhasil, nilai yang dikembalikan adalah pengidentifikasi lokal input sebelumnya. Jika tidak, itu nol.

Untuk mendapatkan informasi kesalahan yang diperluas, gunakan fungsi GetLastError .

Keterangan

Fungsi ini hanya memengaruhi tata letak untuk proses atau utas saat ini.

Fungsi ini tidak dibatasi untuk tata letak keyboard. Parameter hkl sebenarnya adalah pengidentifikasi lokal input. Ini adalah konsep yang lebih luas daripada tata letak keyboard, karena juga dapat mencakup konverter ucapan ke teks, Editor Metode Input (IME), atau bentuk input lainnya. Beberapa pengidentifikasi lokal input dapat dimuat kapan saja, tetapi hanya satu yang aktif pada satu waktu. Memuat beberapa pengidentifikasi lokal input memungkinkan untuk beralih dengan cepat di antara mereka.

Ketika beberapa IMEs diizinkan untuk setiap lokal, meneruskan pengidentifikasi lokal input di mana kata tinggi (gagang perangkat) nol mengaktifkan IME pertama dalam daftar milik lokal.

Bendera KLF_RESET dan KLF_SHIFTLOCK mengubah metode di mana status Caps Lock dimatikan. Secara default, status Caps Lock dimatikan dengan menekan tombol Caps Lock lagi. Jika hanya KLF_RESET yang diatur, status default akan dibuat ulang. Jika KLF_RESET dan KLF_SHIFTLOCK diatur, status Caps Lock dimatikan dengan menekan tombol Caps Lock. Fitur ini digunakan untuk menyesuaikan dengan standar perilaku keyboard lokal serta untuk preferensi pribadi.

Persyaratan


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