LoadKeyboardLayout

Składnia

Argumenty

Argument	Opis
pwszKLID	Nazwa identyfikatora języka. Ten argument składa się z dwóch części: identyfikatora języka (np. dla j. polskiego jest to 0x0415) i identyfikatora urządzenia.
Flags	Określa, w jaki sposób identyfikator ma być załadowany. Ten argument może przyjąć jedną z następujących wartości: KLF_ACTIVATE (0x00000001) Jeśli określony identyfikator nie jest jeszcze załadowany, funkcja załaduje i aktywuje go dla bieżącego wątku. KLF_NOTELLSHELL (0x00000080) Zapobiega otrzymaniu komunikatu HSHELL_LANGUAGE przez procedurę hakową, podczas gdy nowy identyfikator wejścia jest ładowany. Wartość ta jest używana zazwyczaj gdy aplikacja ładuje wiele identyfikatorów jeden po drugim. Użycie tej wartości spowoduje opóźnienie przetwarzania powłoki, aż wszystkie identyfikatory ustawień regionalnych zostaną dodane. KLF_REORDER (0x00000008) Przenosi podany identyfikator do nagłówka listy identyfikatorów, i ustawia go jako aktywny dla aktualnego wątku. Użycie tej wartości spowoduje ponowne ustawienie tejże listy, nawet jeśli nie użyto flagi KLF_ACTIVATE. KLF_REPLACELANG (0x00000010) Jeżeli identyfikator podany w argumencie hkl zawiera ten sam język, co bieżący identyfikator, zastąpi on identyfikator aktualny.  Jeśli ta flaga nie zostanie użyta, w przypadku wystąpienia takiego zdarzenia aktualny identyfikator nie zostanie zastąpiony, a funkcja zwróci wartość NULL. KLF_SUBSTITUTE_OK (0x00000002) Zamienia określony identyfikator na inny, preferowany przez użytkownika. Zmiana zachodzi tylko wtedy, gdy klucz rejestru HKEY_CURRENT_USER\Keyboard Layout\Substitutes wyraźnie definiuje identyfikator. Przykładowo, jeżeli klucz ten zawiera wartość o nazwie "00000409" z wartością "00010409", spowoduje, że zamiast angielskiego układu klawiatury ("00000409") zostanie załadowany układ Dvoraka ("00010409"). Używanie tej flagi jest zalecane. KLF_SETFORPROCESS (0x00000100) Ta flaga działa poprawnie tylko z KLF_ACTIVATE. Po aktywowaniu identyfikatora wysyła komunikat WM_INPUTLANGCHANGE do bieżącego wątku. Zazwyczaj LoadKeyboardLayout aktywuje dany identyfikator tylko dla bieżącego wątku. KLF_UNLOADPREVIOUS Ta wartość jest nieobsługiwana. Użyj funkcji » WinAPI ♦ UnloadKeyboardLayout.

Zwracana wartość

Jeśli wywołanie funkcji powiedzie się, zwróci ona określony identyfikator układu wejścia. Jeśli nie jest on dostępny, zwróconą wartością będzie NULL. Aby uzyskać szczegółowe informacje o błędzie, użyj _{» WinAPI ♦} GetLastError.

Opis szczegółowy

Funkcja LoadKeyboardLayout ładuje nowy lokalny identyfikator układu wejścia do systemu. Ma ona wpływ tylko na układ dla bieżącego procesu lub wątku.

Identyfikator wejścia jest pojęciem szerszym niż układ klawiatury, ponieważ może on obejmować również konwerter speech-to-text, edytor IME, lub inne formy wejścia.

Aplikacja może załadować domyślny identyfikator i może to zrobić poprzez podanie jedynie wersji identyfikatora języka. Jeśli aplikacja chce załadować konkretny IME, powinna zapoznać się z rejestrem w celu jego ustalenia. W tym przypadku zapytanie odnośnie aktywowania domyślnego identyfikatora aktywuje pierwszy do niego pasujący. Specyficzny IME powinien być aktywowany za pomocą jawnego identyfikatora uzyskanego za pomocą funkcji GetKeyboardLayout lub LoadKeyboardLayout.

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Nagłówek	Winuser.h (wewnątrz Windows.h)
Biblioteka	User32.lib
DLL	User32.dll
Nazwy Unicode i ANSI	LoadKeyboardLayoutW (Unicode) i LoadKeyboardLayoutA (ANSI)

Przykład

Zagadnienia powiązane

ActivateKeyboardLayout	Ustawia lokalny identyfikator układu wejścia dla wywołującego wątku lub aktualnego procesu. (funkcja)
UnloadKeyboardLayout	Zwalnia podany identyfikator układu wejścia. (funkcja)

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms646305(v=vs.85).aspx