ITfFnGetLinguisticAlternates-Schnittstelle (ctffunc.h)

Die ITfFnGetLinguisticAlternates-Schnittstelle wird von einem Textdienst und/oder vom TSF-Manager implementiert, um sprachliche Alternativen für den Text in einem bestimmten Bereich bereitzustellen, der als Parameter übergeben wird.

Apps können diese Schnittstelle verwenden, um IME-Alternativen für einen Textbereich abzurufen. Daher stellt die Schnittstelle ITfFnGetLinguisticAlternates zusammen mit ITfFnSearchCandidateProvider einen TSF-basierten Ersatz für die ImmGetConversionList-Funktion bereit. In der Regel implementieren IMEs entweder ITfFnGetLinguisticAlternates oder ITfFnSearchCandidateProvider (oder keines).

Eine App ruft einen Zeiger auf diese Schnittstelle ab, indem sie die ITfFunctionProvider::GetFunction-Methode des TSF-Managers mit IID_ITfFnGetLinguisticAlternates aufruft.

Hinweis Diese Schnittstelle wird möglicherweise nicht für alle IMEs unterstützt. Möglicherweise gibt es Unterschiede bei der Unterstützung zwischen IMEs auf dem Desktop und IMEs in der neuen Windows-Benutzeroberfläche auf Windows 8.1. Einige IMEs implementieren stattdessen die zugehörige Schnittstelle ITfFnSearchCandidateProvider , die als Ersatz für diese API verwendet werden kann. Die empfohlene App-Nutzung besteht darin, zuerst nach dieser Schnittstelle zu suchen, und wenn sie nicht verfügbar ist, überprüfen Sie, ob stattdessen ITfFnSearchCandidateProvider unterstützt wird. IMEs, die die Kompatibilität mit Windows 8 beibehalten möchten, sollten stattdessen ITfFnSearchCandidateProvider implementieren.

 

Vererbung

Die ITfFnGetLinguisticAlternates-Schnittstelle erbt von ITfFunction. ITfFnGetLinguisticAlternates verfügt auch über folgende Membertypen:

Methoden

Die ITfFnGetLinguisticAlternates-Schnittstelle verfügt über diese Methoden.

ITfFnGetLinguisticAlternates::GetAlternates Gibt eine Liste alternativer Zeichenfolgen für einen bestimmten Textbereich zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ctffunc.h

Weitere Informationen

ITfFunction