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

Статья
08/24/2023

Уведомляет IME об изменениях состояния входного контекста.

Синтаксис

BOOL ImmNotifyIME(
       HIMC  unnamedParam1,
  [in] DWORD dwAction,
  [in] DWORD dwIndex,
  [in] DWORD dwValue
);

Параметры

unnamedParam1

[in] dwAction

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

Значение	Значение
NI_CHANGECANDIDATELIST	Приложение изменило текущего выбранного кандидата. Параметр dwIndex указывает индекс списка кандидатов для выбора, и значение dwValue не используется.
NI_CLOSECANDIDATE	Приложение предписывает IME закрыть список кандидатов. Параметр dwIndex указывает индекс закрываемого списка, а dwValue не используется. IME отправляет IMN_CLOSECANDIDATE команду в приложение, если оно закрывает список.
NI_COMPOSITIONSTR	Приложение направляет IME на выполнение действия со строкой композиции. Параметр dwIndex может быть CPS_CANCEL, CPS_COMPLETE, CPS_CONVERT или CPS_REVERT.
NI_IMEMENUSELECTED	Приложение направляет IME, чтобы разрешить приложению обрабатывать указанное меню. Параметр dwIndex указывает идентификатор меню, а dwValue является определяемым приложением значением для этого пункта меню.
NI_OPENCANDIDATE	Приложение направляет IME на открытие списка кандидатов. Параметр dwIndex указывает индекс открываемого списка, а dwValue не используется. IME отправляет IMN_OPENCANDIDATE команду в приложение, если откроется список.
NI_SELECTCANDIDATESTR	Приложение выбрало одного из кандидатов. Параметр dwIndex указывает индекс списка кандидатов для выбора. Параметр dwValue указывает индекс строки кандидата в выбранном списке кандидатов.
NI_SETCANDIDATE_PAGESIZE	Приложение изменяет размер страницы списка кандидатов. Параметр dwIndex указывает список кандидатов для изменения и должен иметь значение в диапазоне от 0 до 3. Параметр dwValue указывает новый размер страницы.
NI_SETCANDIDATE_PAGESTART	Приложение изменяет начальный индекс страницы списка кандидатов. Параметр dwIndex указывает список кандидатов для изменения и должен иметь значение в диапазоне от 0 до 3. Параметр dwValue указывает новый индекс начала страницы.

[in] dwIndex

Индекс списка кандидатов. Кроме того, если параметр dwAction имеет NI_COMPOSITIONSTR, этот параметр может иметь одно из следующих значений.

Значение	Значение
CPS_CANCEL	Очистите строку композиции и задайте для нее состояние без строки композиции.
CPS_COMPLETE	Задайте строку композиции в качестве строки результата.
CPS_CONVERT	Преобразуйте строку композиции.
CPS_REVERT	Отмените текущую строку композиции и задайте для нее неконвертированную строку.

[in] dwValue

Индекс строки-кандидата. Приложение может задать этот параметр или игнорировать его в зависимости от значения параметра dwAction .

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

Возвращает ненулевое значение в случае успешного выполнения или значение 0 в противном случае.

Требования


Минимальная версия клиента	Windows XP [только классические приложения], установленная поддержка восточноазиатских языков.
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	imm.h (включая Immdev.h, Windows.h)
Библиотека	Imm32.lib
DLL	Imm32.dll

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

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

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

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

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