Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The ITfFnGetLinguisticAlternates interface is implemented by a text service and/or by the TSF manager to provide linguistic alternates for the text within a given range passed as a parameter.
Apps can use this interface to obtain IME alternates for a text range; therefore the interface ITfFnGetLinguisticAlternates, along with ITfFnSearchCandidateProvider, provides a TSF-based replacement for the ImmGetConversionList function. Typically IMEs implement either ITfFnGetLinguisticAlternates or ITfFnSearchCandidateProvider (or neither).
An app obtains a pointer to this interface by calling TSF manager ITfFunctionProvider::GetFunction method with IID_ITfFnGetLinguisticAlternates.
Note This interface may not be supported for all IMEs. There may be differences in support between IMEs on the Desktop and IMEs in the new Windows UI on Windows 8.1. Some IMEs instead implement the related interface ITfFnSearchCandidateProvider that can be used as a substitute for this API. Suggested app usage is to check for this interface first, and if it's not available then check if ITfFnSearchCandidateProvider is supported instead. IMEs that wish to maintain compatibility with Windows 8 should implement ITfFnSearchCandidateProvider instead.
Inheritance
The ITfFnGetLinguisticAlternates interface inherits from ITfFunction. ITfFnGetLinguisticAlternates also has these types of members:
Methods
The ITfFnGetLinguisticAlternates interface has these methods.
| ITfFnGetLinguisticAlternates::GetAlternates Returns a list of alternate strings for a given text range. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8.1 [desktop apps only] |
| Minimum supported server | Windows Server 2012 R2 [desktop apps only] |
| Target Platform | Windows |
| Header | ctffunc.h |