LoadKeyboardLayout

LoadKeyboardLayout 함수를 시스템에 새로운 키보드 레이아웃을 로드합니다. 여러 자판 배열을 한 번에 로드할 수 있지만 프로세스 당 하나만 한 번에 활성화 됩니다. 레이아웃 간에 빠르게 전환할 수 있게 로드 하는 여러 자판 배열.

HKL LoadKeyboardLayout (  LPCTSTR  pwszKLID, / / 레이아웃을 로드의 이름UINT플래그 / / 키보드 레이아웃 플래그);
 

매개 변수

pwszKLID
포인터를 로드할 키보드 레이아웃의 이름을 지정 하는 버퍼입니다. 이 이름은 문자열의 16 진수 값으로 구성 된 (낮은 단어) 언어 식별자 와 장치 식별자 (높은 단어). 예를 들어, 미국 영어 언어 식별자를 0x0409, 그래서 있다 기본 미국 영어 레이아웃 "00000409" 라는. "00010409", "00020409" 등등 변종 (Dvorak 레이아웃)와 같은 미국 영어 레이아웃의 이름이.
플래그
자판 배열을 방법은 로드 되도록 지정 합니다. 이 매개 변수는 다음 값 중 하나가 될 수 있습니다.
의미
KLF_ACTIVATE 지정 된 레이아웃 이미 로드 되지 않은 경우 함수를 로드 하 고 활성화 하는 현재 스레드에 대 한 레이아웃.
KLF_NOTELLSHELL HSHELL_LANGUAGE 후크를 코드가 새 레이아웃을 로드 하는 경우에서 ShellProc 후크 프로시저를 방지 합니다. 이 값은 일반적으로 하나의 다른 여러 레이아웃 응용 프로그램이 로드 될 때 사용 됩니다. 셸의 모든 레이아웃 추가 되었습니다 때까지 처리를 지연이 값을 모든 하지만 마지막 레이아웃 적용.
KLF_REORDER 지정 된 레이아웃을 만들고 해당 레이아웃을 현재 스레드에 대 한 활성 레이아웃 키보드 레이아웃 목록 머리 이동 합니다. 이 값이 KLF_ACTIVATE 제공 되지 않은 경우에 키보드 레이아웃 목록 다시 정렬.
KLF_REPLACELANG Windows NT 4.0, Windows 95, 이상:새 레이아웃 레이아웃을 현재와 같은 언어 식별자가 새 레이아웃 해당 언어에 대 한 레이아웃으로 현재 하나를 대체 합니다. 이 값은 제공 되지 않습니다 경우 레이아웃 같은 언어 식별자가 현재 레이아웃이 대체 되지 않습니다 및 함수는 NULL을 반환 합니다.
KLF_SUBSTITUTE_OK 사용자가 선호 하는 다른 레이아웃으로 지정 된 자판을 대체 합니다. 이 플래그가 설정 된 시작 하는 시스템 및 응용 프로그램이 항상이 플래그를 사용 하는 것이 좋습니다. 대체 레지스트리 키 HKEY_CURRENT_USER\Keyboard Layout\Substitutes 명시적으로 대체 레이아웃을 정의 하는 경우에 발생 합니다. 예를 들어, 키 값 이름은 "00000409" 값 "00010409"을 포함 하는 경우 미국 영어 로드 레이아웃 ("00000409") 하면 드 보 락 미국 영어 레이아웃 ("00010409")를 대신 로드 합니다. 시스템을 부팅 하는 경우 KLF_SUBSTITUTE_OK를 사용 하 고는 모든 응용 프로그램 사용이 값 레이아웃을 로드할 때 사용자의 기본 설정이 선택 되어 있는지 확인 하는 것이 좋습니다.
KLF_SETFORPROCESS Windows NT 5.0 및 이후::이 플래그는 KLF_ACTIVATE에만 유효 합니다. 전체 프로세스에 대 한 지정 된 키보드 레이아웃을 활성화 하 고 현재 프로세스의 모든 스레드를 WM_INPUTLANGCHANGE 메시지를 보냅니다. LoadKeyboardLayout 현재 스레드에 대해서만 레이아웃을 활성화 하는 일반적으로.
KLF_UNLOADPREVIOUS Windows NT 5.0, Windows 95 및 Windows 98에서 지원 되지 않습니다:이 플래그와 KLF_ACTIVATE만 유효합니다. 로드 하 고 지정한 레이아웃 활성화 성공 하는 경우에 이전 레이아웃을 언로드합니다. 응용 프로그램 대신 UnloadKeyboardLayout 함수를 사용 하는 것이 좋습니다.

반환 값

함수가 성공 하면 반환 값은 요청한 이름이 일치 하는 레이아웃에 대 한 키보드 레이아웃 핸들. 없음 일치 하는 자판 배열을 사용할 수 있는 경우 반환 값은 NULL입니다. 확장 된 오류 정보를 얻을 하려면 GetLastError.

주의

응용 프로그램 수 것입니다 일반적으로 로드 기본 레이아웃 또는 IME 언어와 언어 식별자의 문자열 버전을 지정 하 여 그렇게 할 수 있습니다. 응용 프로그램 특정 레이아웃 또는 IME를 로드 하려고 하는 경우 그것은 LoadKeyboardLayout에 전달할 특정 레이아웃 식별자를 확인 하려면 레지스트리를 읽어야 한다. 이 경우 로케일에 대 한 기본 키보드 레이아웃 핸들 활성화 요청 첫 번째 일치 하는 하나를 활성화할 것 이다. GetKeyboardLayout, GetKeyboardLayoutList또는 LoadKeyboardLayout 에서 반환 된 명시적 키보드 레이아웃 핸들을 사용 하 여 특정 IME는 활성화 한다.

Windows 95 및 Windows 98: 레이아웃은 로드 하는 경우 이전에 로드 된 레이아웃 및 해당 KLF_REPLACELANG와 같은 언어와 플래그는 설정 되지 않았습니다 , 호출이 실패 합니다. 하나만 로드 레이아웃 특정된 언어와 연결할 수 있습니다. (그것은 동일한 언어 협회와 함께 로드 되도록 여러 입력기에 적합 합니다.)

QuickInfo

nbsp;?Windows &NT: 버전 3.1 이상이 필요 합니다.
Windows:Windows 95 이상이 필요합니다.
Windows CE:지원 되지 않습니다.
헤더:Winuser.h에서 선언합니다.
가져오기 라이브러리:User32.lib를 사용 합니다.
유니코드:Windows NT에서 유니코드와 ANSI 버전으로 구현.

참고 항목

키보드 입력 개요, 키보드 입력 기능, ActivateKeyboardLayout, GetKeyboardLayoutName, MAKELANGID,UnloadKeyboardLayout

 

Index