На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

ActivateKeyboardLayout



The implementations of ActivateKeyboardLayout in Windows 95 and Windows NT are substantially different. To accommodate these differences, this reference page first presents the Windows 95 implementation in its entirety, followed by the Windows NT version.

Windows 95:

The ActivateKeyboardLayout function sets the input language for the current thread. This function accepts a keyboard layout handle that identifies a locale as well as the physical layout of the keyboard.

HKL ActivateKeyboardLayout(

HKL hkl, // handle to keyboard layout
UINT Flags // keyboard layout flags
);


Parameters

hkl

Handle to a keyboard layout or a zero-extended locale identifier. This parameter can be any valid keyboard layout handle obtained using the LoadKeyboardLayout or GetKeyboardLayoutList function or one of the following values:

Value Meaning
HKL_NEXT Selects the next layout in the keyboard layouts list maintained by the system.
HKL_PREV Selects the previous layout in the keyboards layout list maintained by the system.


Flags

Specifies the keyboard layout flags. The value of this parameter can be:

Value Meaning
KLF_REORDER Reorders the keyboard layouts list by moving the given keyboard layout handle to the head of the list. If this value is not given, the list is rotated without a change of order. For example, if a user had an English layout active, as well as having French, German and Spanish layouts loaded (in that order), then activating the German layout with the KLF_REORDER bit set would produce the following order: German, English, French, Spanish. Activating the German layout without the KLF_REORDER value set would produce the following order: German, Spanish, English, French.


Return Values

If the function succeeds, the return value is the previous keyboard layout handle. Otherwise, it is zero. To get extended error information, use the GetLastError function.

Remarks

Several keyboard layouts can be loaded at any one time, but only one is active at a time. Loading multiple keyboard layouts makes it possible to rapidly switch between layouts.
An application can create a valid keyboard layout handle by setting the high word to zero and the low word to a locale identifier. Using such keyboard layout handles changes the input language without affecting the physical layout.
When multiple input method editors (IMEs) are allowed for each locale, passing in a keyboard layout handle in which the high word (the device handle) is zero activates the first IME in the list "belonging" to the locale.

See Also

LoadKeyboardLayout, GetKeyboardLayoutName, UnloadKeyboardLayout


Windows NT:

The ActivateKeyboardLayout function activates a different keyboard layout and sets the active keyboard layout for the entire system rather than the calling thread.

BOOL ActivateKeyboardLayout(

HKL hkl, // handle to keyboard layout
UINT Flags // keyboard layout flags
);


Parameters

hkl

Identifies the keyboard layout to be activated. The layout must have been loaded by a previous call to the LoadKeyboardLayout function. This parameter must be either the handle to a keyboard layout or one of the following values:

Value Meaning
HKL_NEXT Selects the next layout in the circular list of loaded layouts maintained by the system.
HKL_PREV Selects the previous layout in the circular list of loaded layouts maintained by the system.


Flags

Specifies how the keyboard layout is to be activated. This parameter can be one of the following values:

Value Meaning
KLF_REORDER If this bit is set, the system's circular list of loaded keyboard layouts is reordered. If this bit is not set, the list is rotated without a change of order. For example, if a user had an English layout active, as well as having French, German and Spanish layouts loaded (in that order), then activating the German layout with the KLF_REORDER bit set would produce the following order: German, English, French, Spanish. Activating the German layout without the KLF_REORDER bit set would produce the following order: German, Spanish, English, French.If less than three keyboard layouts are loaded, the value of this flag is irrelevant.
KLF_UNLOADPREVIOUS The previously active layout is unloaded.


Return Values

If the function succeeds, the return value is TRUE.
If the function fails, the return value is FALSE. To get extended error information, call GetLastError.

Remarks

Several keyboard layouts can be loaded at any one time, but only one is active at a time. Loading multiple keyboard layouts makes it possible to rapidly switch between layouts.

See Also

LoadKeyboardLayout, GetKeyboardLayoutName, UnloadKeyboardLayout


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

ActivateKeyboardLayout



Реализации ActivateKeyboardLayout в Окне 95 и Windows NT в значительной степени другие. Для того, чтобы размещать эти различия, эта страница ссылки сначала представляет Окну 95 реализаций в своей полноте, сопровожденной версией Окна NT.

Окно 95:

Функция ActivateKeyboardLayout устанавливает входной язык для текущей резьбы. Эта функция принимает клавишную ручку формата, которая идентифицирует место действия, а также физическое размещение клавиатуры.

HKL ActivateKeyboardLayout(

HKL hkl, // РУЧКА на клавишные Флаги / формат UINT/ клавишные флаги формата
);


Параметры

hkl

Прооперируйте клавишный формат или расширенное нулевое место действия идентификатора. Этот параметр может быть любой правильной клавишной ручкой формата получал используя LoadKeyboardLayout или функция GetKeyboardLayoutList или одно из следующего оценивает:

Значение Величины
HKL_NEXT Выбирается следующий формат в клавишном списке форматов поддержанном системой.
HKL_PREV Выбирается предшествующий формат в списке формата клавиатуры поддержанном системой.


Флаги

Определяет клавишные флаги формата. Величина этого параметра может быть:

Значение Величины
KLF_REORDER Преобразовывает клавишный список форматов перемещая данную клавишную ручку формата на голову списка. Если эта величина не дана, список вращан без изменения заказа. Например, если потребитель имел Английский формат активный, а также иметь Французский, Немецкие и Испанские форматы загружали (в том порядке), затем активизируя Немецкий формат с битовым набором KLF_REORDER должно производить следующее порядка: Немецкий, Английский, Французский, Испанский. Активизация Немецкого формата без набора величины KLF_REORDER должна производить следующее порядка: Немецкий, Испанский, Английский, Французский.


Обратные Величины

Если функция добивается успеха, обратная величина является предшествующей клавишной ручкой формата. В противном случае, это нулевое. Для того, чтобы расширять информацию ошибки, используйте функцию GetLastError.

Замечания

Несколько клавишных форматов могут быть загружены в любом времени, но только один активно за один раз. Многочисленные клавишные форматы Загрузки делает возможным быстро переключаться между форматами.
Приложение может создать правильную клавишную ручку формата устанавливая высокое слово в нуль и низкое слово на место действия идентификатора. Используя такие изменения ручек клавишного формата входной язык не влияя на физическое размещение.
Когда многочисленные входные редакторы метода (IMEs) учтены каждое место действия, проходящее в клавишную ручку формата в которой высокое слово ( ручка устройства), - нулевая активизация первый IME в списке "принадлежать" на место действия.

Смотри Также

LoadKeyboardLayout, GetKeyboardLayoutName, UnloadKeyboardLayout


Windows NT:

Функция ActivateKeyboardLayout активизирует другой клавишный формат и устанавливает активному клавишному формату для целой системы а не вызов резьбы.

BOOL ActivateKeyboardLayout(

HKL hkl, // РУЧКА на клавишные Флаги / формат UINT/ клавишные флаги формата
);


Параметры

hkl

Идентифицирует клавишный формат, который нужно активизироваться. Формат по-видимому загружен предшествующим вызовом в функцию LoadKeyboardLayout. Этот параметр должен быть или ручка в клавишный формат или одно из следующего оценивает:

Значение Величины
HKL_NEXT Выбирается следующий формат в циклическом списке загруженных форматов поддержанных системой.
HKL_PREV Выбирается предшествующий формат в циклическом списке загруженных форматов поддержанных системой.


Флаги

Определяет как клавишный формат должен быть активизирован. Этот параметр может быть одним из следующего величин:

Значение Величины
KLF_REORDER Если этот бит установлен, системный циклический список загруженных клавишных форматов преобразован. Если этот бит не установлен, список вращан без изменения заказа. Например, если пользователь имел Английский формат активный, а также иметь Французский, Немецкие и Испанские форматы загружали (в том порядке), затем активизируя Немецкий формат с битовой установкой KLF_REORDER должно производить следующее порядка: Немецкий, Английский, Французский, Испанский. Активизация Немецкого формата без битовой установки KLF_REORDER должна производить следующее порядка: Немецкий, Испанский, Английский, Французский.Если менее чем три клавишных формата загружены, величина этого флага несоответствующая.
KLF_UNLOADPREVIOUS прежде активный формат разгружен.


Обратные Величины

Если функция добивается успеха, обратная величина является ИСТИНОЙ.
Если функция терпит неудачу, обратная величина ЛОЖНАЯ. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Несколько клавишных форматов могут быть загружены в любом времени, но только один активно за один раз. Многочисленные клавишные форматы Загрузки делает возможным быстро переключаться между форматами.

Смотри Также

LoadKeyboardLayout, GetKeyboardLayoutName, UnloadKeyboardLayout


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz