Интерфейс ITfFnGetLinguisticAlternates (ctffunc.h)

  • Статья

Интерфейс ITfFnGetLinguisticAlternates реализуется текстовой службой и/или диспетчером TSF для предоставления лингвистических вариантов для текста в заданном диапазоне, переданного в качестве параметра.

Приложения могут использовать этот интерфейс для получения альтернативных вариантов IME для текстового диапазона; Поэтому интерфейс ITfFnGetLinguisticAlternates вместе с ITfFnSearchCandidateProvider обеспечивает замену функции ImmGetConversionList на основе TSF. Как правило, imes реализуют ITfFnGetLinguisticAlternates или ITfFnSearchCandidateProvider (или ни один из этих вариантов).

Приложение получает указатель на этот интерфейс, вызывая метод ITfFFunctionProvider::GetFunction диспетчера TSF с IID_ITfFnGetLinguisticAlternates.

Примечание Этот интерфейс может поддерживаться не для всех МЕМ. В новом пользовательском интерфейсе Windows на Windows 8.1 могут существовать различия в поддержке МЕ на рабочем столе и imes. Некоторые МЕ вместо этого реализуют связанный интерфейс ITfFnSearchCandidateProvider , который можно использовать в качестве замены для этого API. Рекомендуемое использование приложения — сначала проверка для этого интерфейса, а если он недоступен, то проверка, поддерживается ли ITfFnSearchCandidateProvider. ImEs, которые хотят поддерживать совместимость с Windows 8, должны реализовывать ITfFnSearchCandidateProvider.
 

Наследование

Интерфейс ITfFnGetLinguisticAlternates наследуется от ITfFunction. ITfFnGetLinguisticAlternates также имеет следующие типы членов:

Методы

Интерфейс ITfFnGetLinguisticAlternates содержит следующие методы.

 
ITfFnGetLinguisticAlternates::GetAlternates

Возвращает список альтернативных строк для заданного текстового диапазона.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1 [только классические приложения]
Минимальная версия сервера Windows Server 2012 R2 [только классические приложения]
Целевая платформа Windows
Header ctffunc.h

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

ITfFunction