ITfFnSearchCandidateProvider-Schnittstelle (ctffunc.h)

Ermöglicht eine integrierte Suchumgebung in einem Eingabemethoden-Editor (IME).

Vererbung

Die ITfFnSearchCandidateProvider-Schnittstelle erbt von der IUnknown-Schnittstelle . ITfFnSearchCandidateProvider verfügt auch über folgende Arten von Membern:

Methoden

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

ITfFnSearchCandidateProvider::GetSearchCandidates Ruft eine Liste der Konvertierungskandidaten für eine bestimmte Zeichenfolge ab, ohne IME-bezogene Nachrichten oder Ereignisse zu generieren.
ITfFnSearchCandidateProvider::SetResult Stellt einen TextDienst oder IME mit Verlaufsdaten bereit, wenn ein Kandidat vom Benutzer ausgewählt wird.

Hinweise

Implementieren Sie die ITfFnSearchCandidateProvider-Schnittstelle in Ihrem Eingabemethoden-Editor (IME), um eine integrierte Suchumgebung zu aktivieren. Durch die Implementierung dieser Schnittstelle können Suchvorgänge mit aussagekräftigen Ergebnissen beginnen, bevor die IME-Eingabe abgeschlossen wurde, indem eine Reihe möglicher IME-Konvertierungskandidaten für eine bestimmte Eingabezeichenfolge bereitgestellt wird. Apps können diese Schnittstelle verwenden, um IME-Konvertierungen für eine Zeichenfolge abzurufen. Daher stellt die ITfFnSearchCandidateProvider-Schnittstelle zusammen mit ITfFnGetLinguisticAlternates einen TSF-basierten Ersatz für die ImmGetConversionList-Funktion bereit. In der Regel implementieren IMEs entweder ITfFnGetLinguisticAlternates oder ITfFnSearchCandidateProvider (oder keines).

Rufen Sie GetFunctionProvider mit der CLSID eines Textdiensts auf, um einen ITfFunctionProvider-instance abzurufen. Verwenden Sie den folgenden Aufruf der ITfFunctionProvider::GetFunction-Methode , um den ITfFnSearchCandidateProvider-Schnittstellenzeiger abzurufen.

ITfFunctionProvider::GetFunction(GUID_NULL, IID_ITfFnSearchCandidateProvider, &pSearchCandidate)

Anforderungen

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

Weitere Informationen

GetFunction

GetFunctionProvider

IUnknown

SearchPaneQueryLinguisticDetails