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

Статья
02/27/2024

Уведомляет 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	immdev.h (включая Immdev.h, Windows.h)
Библиотека	Imm32.lib
DLL	Imm32.dll

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

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

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

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

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