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

Метод ITfReverseConversionMgr::GetReverseConversion (msctf.h)

  • Статья

[GetReverseConversion доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Только для внутреннего использования.]

Извлекает объект ITfReverseConversion , который может выполнять обратные преобразования.

Синтаксис

HRESULT GetReverseConversion(
  [in]  LANGID               langid,
  [in]  REFGUID              guidProfile,
  [in]  DWORD                dwflag,
  [out] ITfReverseConversion **ppReverseConversion
);

Параметры

[in] langid

Идентификатор языка профиля, которому принадлежат целевые строки.

[in] guidProfile

GUID профиля, которому принадлежат целевые строки.

[in] dwflag

Значение Значение
TF_RCM_COMLESS
0x00000001
 Активируйте интерфейс обратного преобразования без COM.
TF_RCM_VKEY
0x00000002
 Выходные данные должны быть массивом кодов виртуальных ключей (а не кодов символьных ключей).
TF_RCM_HINT_READING_LENGTH
0x00000004
 При обратном преобразовании порядок записей в списке выходных данных должен определяться приоритетом в зависимости от длины входной последовательности, причем сначала самые короткие последовательности. Вполне возможно, что входная последовательность с низким числом конфликтов может быть гораздо выше, чем последовательность входных данных с аналогичным (но немного большим) числом столкновений. Интерпретация этого флага зависит от IME.
TF_RCM_HINT_COLLISION
0x00000008
 При обратном преобразовании приоритет должен определяться порядок записей в списке выходных данных на основе количества конфликтов, при этом записи сначала содержат наименьшее число конфликтов. Если входная последовательность соответствует гораздо большему значению символов, чем немного длинная входная последовательность, может быть предпочтительнее использовать более длинную последовательность ввода. IME определяет, повлияет ли этот флаг на выходные данные обратного преобразования.

[out] ppReverseConversion

Указатель на адрес объекта ITfReverseConversion, который может выполнять указанное обратное преобразование.

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

Этот метод может возвращать одно из этих значений.

Возвращаемое значение Описание
S_OK
 Доступен ITfReverseConversion для указанного сочетания langid и guidProfile .
E_NOTIMPL
 Указанное сочетание langid и guidProfile не поддерживает обратное преобразование.
E_FAIL
 Произошла неизвестная ошибка.

Комментарии

Обратное преобразование предоставляет последовательности нажатий клавиш, необходимые для создания указанной строки.

Если для dwflag не указан флаг TF_RCM_HINT_COLLISION или TF_RCM_HINT_READING_LENGTH, IME может не упорядочить выходные данные в любом порядке.

Требования

Требование Значение
Минимальная версия клиента Windows Vista с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2008 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа Windows
Header msctf.h
DLL Msctf.dll

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

ITfReverseConversionMgr