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


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

Уведомляет 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

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

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