GetKeyboardLayoutList 関数 (winuser.h)

システムにある現在の入力ロケールのセットに対応する、入力ロケール識別子 (以前はキーボード レイアウト ハンドルと呼ばれていました) を取得します。 この関数は、指定したバッファーに識別子をコピーします。

構文

int GetKeyboardLayoutList(
  [in]  int nBuff,
  [out] HKL *lpList
);

パラメーター

[in] nBuff

型: int

バッファーが保持できるハンドルの最大数。

[out] lpList

種類: HKL*

入力ロケール識別子の配列を受け取るバッファーへのポインター。

戻り値

型: int

関数が成功した場合、戻り値はバッファーにコピーされた入力ロケール識別子の数です。 nBuff が 0 の場合、戻り値は、現在のすべての入力ロケール識別子を受け取るために必要なバッファーのサイズ (配列要素) になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

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

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

関連項目

概念

GetKeyboardLayout

キーボード入力

参照