Функция GetKeyboardLayoutList (winuser.h)

Статья
08/27/2023

Извлекает идентификаторы входного языкового стандарта (ранее называемые дескрипторами раскладки клавиатуры), соответствующие текущему набору входных языковых стандартов в системе. Функция копирует идентификаторы в указанный буфер.

Синтаксис

int GetKeyboardLayoutList(
  [in]  int nBuff,
  [out] HKL *lpList
);

Параметры

[in] nBuff

Тип: int

Максимальное количество дескрипторов, которые может содержать буфер.

[out] lpList

Тип: HKL*

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

Возвращаемое значение

Тип: int

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

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

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

Начиная с Windows 8: Предпочтительным методом для получения языка, связанного с текущей раскладкой клавиатуры или методом ввода, является вызов Windows.Globalization.Language.CurrentInputMethodLanguageTag. Если приложение передает языковые теги из CurrentInputMethodLanguageTag в любые функции поддержки национальных языков , оно должно сначала преобразовать теги, вызвав ResolveLocaleName.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll

См. также раздел

Основные понятия

GetKeyboardLayout

Ввод с клавиатуры

Справочные материалы

Share via