GetKeyboardLayout 関数 (winuser.h)

[アーティクル]
03/04/2024

アクティブな入力ロケール識別子 (以前はキーボードレイアウトと呼ばれます) を取得します。

構文

HKL GetKeyboardLayout(
  [in] DWORD idThread
);

パラメーター

[in] idThread

型: DWORD

クエリを実行するスレッドの識別子。現在のスレッドの場合は 0。

戻り値

種類: HKL

戻り値は、スレッドの入力ロケール識別子です。低い単語には入力言語の言語識別子が含まれており、高い単語にはキーボードの物理レイアウトへのデバイスハンドルが含まれています。

注釈

入力ロケール識別子は、音声テキスト変換、Input Method エディター (IME)、またはその他の形式の入力も含めることができるため、キーボードレイアウトよりも広範な概念です。

キーボードレイアウトは動的に変更できるため、現在のキーボードレイアウトに関する情報をキャッシュするアプリケーションでは、入力言語の変更を通知するWM_INPUTLANGCHANGE メッセージを処理する必要があります。

現在アクティブな HKL の KLID (キーボードレイアウト ID) を取得するには、 GetKeyboardLayoutName を呼び出します。

Windows 8 以降: 現在のキーボードレイアウトまたは入力メソッドに関連付けられている言語を取得するために推奨されるメソッドは、Windows.Globalization.Language.CurrentInputMethodLanguageTag の呼び出しです。アプリが CurrentInputMethodLanguageTag から各国語サポート関数に言語タグを渡す場合は、最初に ResolveLocaleName を呼び出してタグを変換する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll