Функция ImmGetImeMenuItemsA (imm.h)

Статья
11/20/2024

Извлекает элементы меню, зарегистрированные в меню IME указанного входного контекста.

Синтаксис

DWORD ImmGetImeMenuItemsA(
  [in]            HIMC               unnamedParam1,
  [in]            DWORD              unnamedParam2,
  [in]            DWORD              unnamedParam3,
  [out, optional] LPIMEMENUITEMINFOA lpImeParentMenu,
  [out, optional] LPIMEMENUITEMINFOA lpImeMenu,
  [in]            DWORD              dwSize
);

Параметры

[in] unnamedParam1

Обработка входного контекста для указанных элементов меню.

[in] unnamedParam2

Флаг, указывающий параметры меню. Определяется следующее значение.

Ценность	Значение
IGIMIF_RIGHTMENU	Получите элементы меню для контекстного меню, полученного щелчком правой кнопкой мыши.

[in] unnamedParam3

Тип меню для извлечения. Этот параметр может иметь одно или несколько следующих значений.

Ценность	Значение
IGIMII_CMODE	Извлеките элементы меню, управляющие режимом преобразования.
IGIMII_SMODE	Получите элементы меню, управляющие режимом предложения.
IGIMII_CONFIGURE	Получите элементы меню, связанные с конфигурацией IME.
IGIMII_TOOLS	Получите элементы меню, связанные с инструментами IME.
IGIMII_HELP	Получите элементы меню, управляющие справкой по IME.
IGIMII_OTHER	Получите элементы меню, управляющие другими функциями IME.
IGIMII_INPUTTOOLS	Извлеките элементы меню, управляющие элементами меню, связанными с средствами ввода IME, предоставляющими расширенный способ ввода символов.

[out, optional] lpImeParentMenu

Указатель на структуру IMEMENUITEMINFO , в которой функция получает сведения родительского меню. Чтобы получить сведения о элементах подменю этого родительского меню, приложение задает элемент fType MFT_SUBMENU. Этот параметр содержит NULL, если функция извлекает только элементы меню верхнего уровня.

[out, optional] lpImeMenu

Указатель на массив структур IMEMENUITEMINFO, в которых функция получает сведения о элементах меню. Этот параметр содержит null, если функция извлекает количество зарегистрированных элементов меню.

[in] dwSize

Размер буфера для получения структуры IMEMENUITEMINFO .

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

Возвращает количество элементов меню, скопированных в lpImeMenu. Если lpImeMenu указывает NULL, функция возвращает количество зарегистрированных элементов меню в указанном контексте ввода.

Замечания

Заметка

Заголовок imm.h определяет ImmGetImeMenuItems как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения], установленная поддержка языка Восточной Азии.
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	imm.h (include Immdev.h, Windows.h)
библиотеки	Imm32.lib
DLL	Imm32.dll

См. также

IMEMENUITEMINFO

диспетчера методов ввода

Функции диспетчера методов ввода

Поделиться через