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

Метод IImePad::Request (imepad.h)

  • Статья

Вызывается IImePadApplet для вставки текста в приложение.

Запрос — это единственный метод, который может вызывать IImePadApplet . Вызывая этот метод с одним из идентификаторов запросов IMEPADREQ_* , IImePadApplet может вставлять текст в приложение и управлять строкой композиции IME в приложении.

Синтаксис

HRESULT Request(
  [in]      IImePadApplet *pIImePadApplet,
  [in]      INT           reqId,
  [in, out] WPARAM        wParam,
  [in, out] LPARAM        lParam
);

Параметры

[in] pIImePadApplet

Указатель интерфейса вызывающего приложения.

[in] reqId

Тип запроса (идентификатор запроса). Для этого параметра необходимо задать одно из следующих значений:

Значение Значение
IMEPADREQ_INSERTSTRING
 Вставьте строку в приложение в виде строки композиции.
  • wParam: указатель на строку, завершаемую null (LPWSTR), которая должна быть вставлена в приложение.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_SENDCONTROL
 Управляет композицией строки и курсора в приложении.
  • wParam: указывает значение элемента управления (IMEPADCTRL_*), которое запрашивает IME для обработки строки композиции и позиции курсора. Список значений IMEPADCTRL_* см. в разделе Примечания.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_SETAPPLETSIZE
 Задайте новый размер окна апплета.
  • wParam: LOWORD(wParam) указывает ширину апплета. HIWORD(wParam) указывает высоту апплета
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_GETCOMPOSITIONSTRING
 Возвращает текущий текст строки композиции.
  • wParam: указывает на буфер (LPWSTR), который получает текущий текст строки композиции.
  • lParam: максимальное количество копирующихся символов, включая завершающий символ NULL.
IMEPADREQ_GETCOMPOSITIONSTRINGINFO
 Возвращает сведения о текущей строке композиции.
  • wParam: указатель на структуру IMECOMPOSITIONSTRINGINFO , которая получает сведения о композиции.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_DELETESTRING
 Удалите строку композиции.
  • wParam: LOWORD(wParam) указывает начальную позицию удаляемой строки композиции. HIWORD(wParam) указывает длину удаляемой строки композиции.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_CHANGESTRING
 Замените часть строки композиции.
  • wParam: указатель на строку замены (LPWSTR).
  • lParam: LOWORD(lParam) указывает начальную позицию строки композиции, которая должна быть заменена. HIWORD(lParam) указывает длину заменяемой строки композиции.
IMEPADREQ_GETAPPLHWND
 Возвращает дескриптор окна приложения.
  • wParam: адрес дескриптора HWND (HWND *) для получения дескриптора окна приложения.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_FORCEIMEPADWINDOWSHOW
 Окно ImePad остается видимым.
  • wParam: значение TRUE , чтобы окно IMEPad отображалось.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_POSTMODALNOTIFY
 Заставляет IImePad асинхронно вызывать метод applet Notify с определенным идентификатором уведомления и определяемыми пользователем данными.
  • wParam: код уведомления (IMEPN_*). Сведения о возможных кодах IMEPN_*, см. в примечаниях к IImePadApplet::Notify.
  • lParam: определяемые пользователем данные
IMEPADREQ_GETDEFAULTUILANGID
 Возвращает рекомендуемый (по умолчанию) язык пользовательского интерфейса приложения ImePad.
  • wParam: адрес идентификатора языка (LANGID *) для получения языка пользовательского интерфейса по умолчанию.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_GETCURRENTUILANG
 Получите текущий язык пользовательского интерфейса приложения ImePad.
  • wParam: адрес идентификатора языка (LANGID *) для получения текущего языка пользовательского интерфейса.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_GETAPPLETUISTYLE
 Возвращает стиль пользовательского интерфейса приложения (флаги IPAWS_* ).
  • wParam: адрес для получения стиля пользовательского интерфейса приложения (DWORD *). Стиль представляет собой сочетание флагов IPAWS_* ; Сведения о возможных флагах IPAWS_* см. в разделе Примечания.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_SETAPPLETUISTYLE
 Задает стиль пользовательского интерфейса приложения (флаги IPAWS_* ).
  • wParam: стиль пользовательского интерфейса Applet. Стиль представляет собой сочетание флагов IPAWS_* ; Сведения о возможных флагах IPAWS_* см. в разделе Примечания.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_ISAPPLETACTIVE
 Определяет, активна ли апплет.
  • wParam: адрес для получения значения (BOOL *). Если задано значение TRUE, апплет активен; в противном случае апплет не активен.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_ISIMEPADWINDOWVISIBLE
 Определяет, отображается ли ImePad.
  • wParam: адрес для получения значения (BOOL *). Если задано значение TRUE, отображается ImePad; в противном случае ImePad не отображается.
  • lParam: не используется. Должен иметь значение 0.
IMEPADREQ_SETAPPLETMINMAXSIZE
 Задайте минимальный и максимальный размер апплета.
  • wParam: LOWORD(wParam) указывает ширину апплета. HIWORD(wParam) указывает высоту апплета.
  • lParam: значение TRUE задает максимальный размер; ЗНАЧЕНИЕ FALSE для установки минимального размера.
IMEPADREQ_GETCONVERSIONSTATUS
 Возвращает состояние преобразования текущего приложения IME. Полный список режимов преобразования и предложений см. в файле заголовка Imm.h.
  • wParam: адрес для получения режима преобразования (DWORD *).
  • lParam: адрес для получения режима предложения (DWORD *).
IMEPADREQ_GETVERSION
 Возвращает сведения о версии IImePad.
  • wParam: адрес для получения основной версии (DWORD *).
  • lParam: адрес для получения дополнительной версии (DWORD *).
IMEPADREQ_GETCURRENTIMEINFO
 Возвращает сведения о редакторе редактора, вызвавав ImePad.
  • wParam: адрес для получения идентификатора языка IME (DWORD *).
  • lParam: адрес для получения входного идентификатора IME (DWORD *).

[in, out] wParam

Дополнительные сведения, относящиеся к reqId.

[in, out] lParam

Дополнительные сведения, относящиеся к reqId.

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

S_OK в случае успешного выполнения, в противном случае E_FAIL.

Комментарии

Возможные значения IMEPADCTRL_*

Ниже приведены возможные значения, которые wParam может принимать, если reqId имеет значение IMEPADREQ_SENDCONTROL:
Имя Значение Описание
IMEPADCTRL_CONVERTALL 1 Преобразование всех строк композиции.
IMEPADCTRL_DETERMINALL 2 Определите все строки композиции.
IMEPADCTRL_DETERMINCHAR 3 Определите символ строки композиции указанного счетчика.
IMEPADCTRL_CLEARALL 4 Очистите все строки композиции.
IMEPADCTRL_CARETLEFT 6 Перемещение курсора символа влево.
IMEPADCTRL_CARETRIGHT 7 Перемещение курсора символа вправо.
IMEPADCTRL_CARETTOP 8 Перемещение курсора символа в начало строки композиции.
IMEPADCTRL_CARETBOTTOM 9 Перемещение курсора символа в конец строки композиции.
IMEPADCTRL_CARETBACKSPACE 10 Удалите символ строки композиции перед курсором (например, клавишу BACKSPACE).
IMEPADCTRL_CARETDELETE 11 Удалите символ строки композиции после курсора (например, клавишу DELETE).
IMEPADCTRL_PHRASEDELETE 12 Удалите фразу строки композиции.
IMEPADCTRL_INSERTSPACE 13 Вставьте пробел — полную ширину или половину ширины в зависимости от конфигурации IME.
IMEPADCTRL_INSERTFULLSPACE 14 Вставьте пробел полной ширины.
IMEPADCTRL_INSERTHALFSPACE 15 Вставка интервала половины ширины.
IMEPADCTRL_ONIME 16 Установите IME ON.
IMEPADCTRL_OFFIME 17 Установите IME OFF.
IMEPADCTRL_ONPRECONVERSION 18 Установите параметр ON для предварительного преобразования.
IMEPADCTRL_OFFPRECONVERSION 19 Установите значение OFF для предварительного преобразования.
IMEPADCTRL_PHONETICCANDIDATE 20 Откройте кандидата IME.
 

Возможные значения IPAWS_*

Ниже приведены возможные значения, которые можно получить с помощью wParam , если reqId имеет значение IMEPADREQ_GETAPPLETUISTYLE, или значение wParam , если reqId имеет значение IMEPADREQ_SETAPPLETUISTYLE:
Имя Описание
IPAWS_ENABLED Отображение апплета в качестве включенного окна.
IPAWS_SIZINGNOTIFY Отправьте IMEPN_SIZECHANGING или IMEPN_SIZECHANGED код уведомления в приложение.
IPAWS_VERTICALFIXED Фиксированная по вертикали.
IPAWS_HORIZONTALFIXED По горизонтали.
IPAWS_SIZEFIXED Размер является фиксированным.
IPAWS_MAXWIDTHFIXED Максимальная ширина фиксирована.
IPAWS_MAXHEIGHTFIXED Максимальная высота фиксирована.
IPAWS_MAXSIZEFIXED Максимальный размер фиксирован.
IPAWS_MINWIDTHFIXED Минимальная ширина фиксирована.
IPAWS_MINHEIGHTFIXED Минимальная высота фиксирована.
IPAWS_MINSIZEFIXED Минимальный размер является фиксированным.

Требования

   
Целевая платформа Windows
Header imepad.h

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

IImePad

IImePadApplet

IMECOMPOSITIONSTRINGINFO