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 |