ActivateKeyboardLayout

[funkcja] Ustawia lokalny identyfikator układu wejścia dla wywołującego wątku lub aktualnego procesu.

Składnia

#include <windows.h>

HKL WINAPI ActivateKeyboardLayout(
HKL hkl,
UINT Flags
);

Argumenty

Argument Opis

hkl

Argument	Opis
hkl	Identyfikator układu wejścia, który zostanie załadowany. Musi on być załadowany przez uprzednie wywołanie funkcji _{» WinAPI ♦}LoadKeyboardLayout. Może on być albo uchwytem do tego identyfikatora, albo jedną z następujących wartości: HKL_NEXT (1) Aktywuje następny identyfikator z listy przechowywanej w systemie. HKL_PREV (0) Aktywuje poprzedni identyfikator z listy przechowywanej w systemie.
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_REORDER (0x00000008) Jeżeli ta flaga zostanie ustawiona, systemowa lista identyfikatorów pozostanie w obecnej kolejności. Dla przykładu, jeśli aktualnym układem klawiatury jest angielski, ale załadowane są także francuski, niemiecki i hiszpański (w tej kolejności), aktywowanie niemieckiego z użyciem tej flagi spowoduje powstanie następującej listy: niemiecki, angielski, francuski, hiszpański. Jeśli flaga nie zostanie użyta, może powstać następujący porządek: niemiecki, hiszpański, angielski, francuski. Jeśli liczba załadowanych identyfikatorów w systemie jest mniejsza niż 3, użycie tej flagi nie ma znaczenia. KLF_RESET (0x40000000) Jeśli ta flaga zostanie podana, ale `KLF_SHIFTLOCK` nie, Caps Lock będzie wyłączany aż do naciśnięcia tego klawisza ponownie. Jeżeli obie te flagi zostaną podane, stan Caps Locka będzie wyłączany poprzez naciśnięcie klawisza Shift. Te dwie metody wzajemnie się wykluczają, a ustawienia zostaną zapisane w rejestrze. KLF_SETFORPROCESS (0x00000100) Aktywuje podany identyfikator i wysyła komunikat `WM_INPUTLANGCHANGE` do bieżącego wątku. KLF_SHIFTLOCK (0x00010000) Ta flaga jest używana tylko z flagą `KLF_RESET`. KLF_UNLOADPREVIOUS Ta wartość jest nieobsługiwana. Użyj funkcji _{» WinAPI ♦}UnloadKeyboardLayout.

Identyfikator układu wejścia, który zostanie załadowany. Musi on być załadowany przez uprzednie wywołanie funkcji _{» WinAPI ♦}LoadKeyboardLayout. Może on być albo uchwytem do tego identyfikatora, albo jedną z następujących wartości:

HKL_NEXT (1)
Aktywuje następny identyfikator z listy przechowywanej w systemie.
HKL_PREV (0)
Aktywuje poprzedni identyfikator z listy przechowywanej w systemie.

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_REORDER (0x00000008)
Jeżeli ta flaga zostanie ustawiona, systemowa lista identyfikatorów pozostanie w obecnej kolejności.
Dla przykładu, jeśli aktualnym układem klawiatury jest angielski, ale załadowane są także francuski, niemiecki i hiszpański (w tej kolejności), aktywowanie niemieckiego z użyciem tej flagi spowoduje powstanie następującej listy: niemiecki, angielski, francuski, hiszpański. Jeśli flaga nie zostanie użyta, może powstać następujący porządek: niemiecki, hiszpański, angielski, francuski.
Jeśli liczba załadowanych identyfikatorów w systemie jest mniejsza niż 3, użycie tej flagi nie ma znaczenia.
KLF_RESET (0x40000000)
Jeśli ta flaga zostanie podana, ale KLF_SHIFTLOCK nie, Caps Lock będzie wyłączany aż do naciśnięcia tego klawisza ponownie. Jeżeli obie te flagi zostaną podane, stan Caps Locka będzie wyłączany poprzez naciśnięcie klawisza Shift. Te dwie metody wzajemnie się wykluczają, a ustawienia zostaną zapisane w rejestrze.
KLF_SETFORPROCESS (0x00000100)
Aktywuje podany identyfikator i wysyła komunikat WM_INPUTLANGCHANGE do bieżącego wątku.
KLF_SHIFTLOCK (0x00010000)
Ta flaga jest używana tylko z flagą KLF_RESET.
KLF_UNLOADPREVIOUS
Ta wartość jest nieobsługiwana. Użyj funkcji _{» WinAPI ♦}UnloadKeyboardLayout.

Zwracana wartość

Jeśli wywołanie funkcji powiedzie się, zwróci ona poprzedni identyfikator układu wejścia. W przeciwnym wypadku zwróci 0. Aby uzyskać szczegółowe informacje o błędzie, użyj funkcji _{» WinAPI ♦}GetLastError.

Opis szczegółowy

Funkcja ActivateKeyboardLayout ustawia lokalny identyfikator układu wejścia dla wywołującego wątku lub aktualnego procesu.

ActivateKeyboardLayout nie ogranicza się tylko do układu klawiatury. Identyfikator wejścia jest pojęciem szerszym niż ten układ, ponieważ może on obejmować również konwerter speech-to-text, edytor IME, lub inne formy wejścia. Kilka identyfikatorów może być załadowanych w dowolnym czasie, ale tylko jeden może być aktywny w danej chwili. Ładowanie wielu identyfikatorów pozwala szybko przełączać się między nimi.

Kiedy dla każdego ustawienia jest dozwolonych wiele IME, podanie identyfikatora w którym wyższe słowo wynosi zero, spowoduje aktywowanie pierwszego IME na liście.

Podając flagi KLF_RESET i KLF_SHIFTLOCK można modyfikować sposób wyłączania klawisza Caps Lock. Ta opcja używana jest w celu dostosowania się do lokalnych standardów jak i osobistych preferencji.

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

Zagadnienia powiązane

LoadKeyboardLayout	Ładuje nowy lokalny identyfikator układu wejścia do systemu. (funkcja)
UnloadKeyboardLayout	Zwalnia podany identyfikator układu wejścia. (funkcja)

Linki zewnętrzne

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

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.