Функция SendIMEMessageExW (ime.h)

Статья
11/20/2024

[Эта функция устарела и не должна использоваться.]

Задает действие или обработку редактора методов ввода (IME) с помощью указанной подфункции.

Синтаксис

LRESULT SendIMEMessageExW(
       HWND   unnamedParam1,
       LPARAM unnamedParam2
);

Параметры

unnamedParam1

unnamedParam2

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

Результат обработки подфункции. Если результат не выполнен, один из следующих кодов ошибок хранится в wParam структуры IMESTRUCT.

Возвращаемый код	Описание
IME_RS_DISKERROR	Ошибка диска.
IME_RS_ERROR	Общая ошибка.
IME_RS_ILLEGAL	Содержит недопустимый символ.
IME_RS_INVALID	Недопустимая подфункция.
IME_RS_NEST	Подфункция вложена и, следовательно, не может использоваться.
IME_RS_NOIME	IME не выбран (не установлен).
IME_RS_NOROOM	Не хватает области.
IME_RS_NOTFOUND	Кандидат не найден.
IME_RS_SYSTEMMODAL	Windows находится в системном режиме, данные не могут передаваться в IME.
IME_RS_TOOLONG	Слишком длинные символы.

Замечания

SendIMEMessageEx гарантирует действие, указанное в спецификациях только для imEs, поддерживающих сообщение WM_CONVERTREQUESTEX. Для IME, который не поддерживает WM_CONVERTREQUESTEX, SendIMEMessageEx отправляет WM_CONVERTREQUEST сообщение в IME и возвращает содержимое wParam члена структуры IMESTRUCT. Если обработка подфункций не завершена обычно, эти функции задают IME_RS_ERROR в wParam.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	ime.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll

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