GetKeyboardLayout 함수(winuser.h)

활성 입력 로캘 식별자(이전의 키보드 레이아웃이라고 함)를 검색합니다.

구문

HKL GetKeyboardLayout(
  [in] DWORD idThread
);

[in] idThread

형식:DWORD

쿼리할 스레드의 식별자이거나 현재 스레드의 경우 0입니다.

형식: HKL

반환 값은 스레드의 입력 로캘 식별자입니다. 낮은 단어에는 입력 언어에 대한 언어 식별자가 포함되고 상위 단어에는 키보드의 실제 레이아웃에 대한 디바이스 핸들이 포함됩니다.

입력 로캘 식별자는 음성 텍스트 변환기, 입력 메서드 편집기(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 포함)
라이브러리	User32.lib
DLL	User32.dll