10.16.1.1 - Функция ActivateKeyboardLayout

(АктивизацияРаскладкиКлавиатуры)

Выполнение функции в среде Windows 95 и Windows NT существенно различается. Чтобы выявить эти различия, эта страница справочника первые представляет ее реализацию в среде Windows 95 во всей полноте, в соответствии с версией Windows NT.

Windows 95:

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

Синтаксис

HKL ActivateKeyboardLayout
(
	HKL hkl,		// дескриптор раскладки клавиатуры
	UINT Flags	// флажки раскладки клавиатуры
);

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

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

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

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

Смотри также
LoadKeyboardLayout, GetKeyboardLayoutName, UnloadKeyboardLayout

Windows NT:

Функция ActivateKeyboardLayout активизирует другую раскладку символов на клавиатуре и устанавливает активную раскладку символов в целом для системы, а не для вызывающего потока.

Синтаксис

BOOL ActivateKeyboardLayout(
	HKL hkl,		// дескриптор раскладки клавиатуры
	UINT Flags	// флажки раскладки клавиатуры
);

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

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

Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - ИСТИНА (TRUE).
Если функция не выполняет задачу, величина возвращаемого значения - ЛОЖЬ(FALSE). Чтобы получить расширенные данные об ошибках, вызовите GetLastError.

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

Смотри также
LoadKeyboardLayout, GetKeyboardLayoutName, UnloadKeyboardLayout

Размещение и совместимость ActivateKeyboardLayout

Windows NT				Да 
Win95					Да 
Win32s					Нет 
Импортируемая библиотека			user32.lib 
Заголовочный файл				winuser.h 
Unicode					Нет 
Замечания по платформе			Не имеется

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков.