ActivateKeyboardLayout

呼び出し元スレッドまたは現在のプロセスに対して入力ロケール識別子 (旧称: キーボードレイアウトハンドル) を設定する。入力ロケール識別子はロケールとキーボードの物理レイアウトを指定する。

ActivateKeyboardLayout hkl, Flags

hkl : [intptr] 型: HKL アクティブにする入力ロケール識別子。
Flags : [int] 型: UINT

(プラグイン / モジュール : user32.dll)

解説

呼び出し元スレッドまたは現在のプロセスに対して入力ロケール識別子 (旧称: キーボードレイアウトハンドル)
を設定する。入力ロケール識別子はロケールとキーボードの物理レイアウトを指定する。

[戻り値]
型: HKL 戻り値の型は HKL である。関数が成功した場合、戻り値は直前の入力ロケール識別子。失敗した場合は
0。拡張エラー情報を取得するには GetLastError 関数を使用する。

[備考]
この関数は現在のプロセスまたはスレッドのレイアウトのみに影響する。この関数はキーボードレイアウトに限定されない。hkl
パラメータは実際には入力ロケール識別子であり、これはキーボードレイアウトより広い概念で、音声入力変換器、IME (Input Method
Editor)、その他の入力形式を含む場合がある。複数の入力ロケール識別子を同時にロードしておくことができるが、アクティブにできるのは一度に
1 つだけである。複数ロードしておくと素早く切り替えられる。1 つのロケールに対して複数の IME が許可されている場合、上位ワード
(デバイスハンドル) がゼロの入力ロケール識別子を渡すと、そのロケールに属するリストの最初の IME
がアクティブになる。KLF_RESET および KLF_SHIFTLOCK フラグは、Caps Lock
状態の解除方法を変更する。既定では Caps Lock キーを再度押すことで解除される。KLF_RESET
のみ指定すると既定の状態に戻る。KLF_RESET と KLF_SHIFTLOCK を指定すると、いずれかの Caps Lock
キーを押すことで解除されるようになる。この機能は地域のキーボード動作標準や個人の好みに合わせるためにある。

情報

プラグイン / モジュールuser32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の user32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_user32_gen2.hs