GetKeyboardLayout 函式 (winuser.h)

擷取先前稱為鍵盤配置 () 的作用中輸入地區設定標識符。

語法

HKL GetKeyboardLayout(
  [in] DWORD idThread
);

[in] idThread

類型： DWORD

要查詢的線程標識碼，或目前線程的 0。

類型： HKL

傳回值是線程的輸入地區設定標識碼。低字包含輸入語言的語言標識碼，而高字則包含鍵盤實體版面配置的裝置句柄。

輸入地區設定標識碼是比鍵盤版面配置更廣泛的概念，因為它也可以包含語音轉換程式、輸入方法編輯器 (輸入法) 或任何其他形式的輸入。

由於鍵盤配置可以動態變更，所以快取目前鍵盤配置相關信息的應用程式應該處理 WM_INPUTLANGCHANGE 訊息，以通知輸入語言中的變更。

若要取得目前作用中 HKL) 的 KLID (鍵盤配置識別碼，請呼叫 GetKeyboardLayoutName。

從 Windows 8 開始：擷取與目前鍵盤配置或輸入法相關聯的語言慣用方法是呼叫 Windows.Globalization.Language.CurrentInputMethodLanguageTag。如果您的應用程式將語言標記從 CurrentInputMethodLanguageTag 傳遞至任何國家語言支援函式，則必須先呼叫 ResolveLocaleName 來轉換標記。