ITfFnSearchCandidateProvider インターフェイス (ctffunc.h)
入力メソッド エディター (IME) で統合された検索エクスペリエンスを有効にします。
継承
ITfFnSearchCandidateProvider インターフェイスは、IUnknown インターフェイスから継承します。 ITfFnSearchCandidateProvider には、次の種類のメンバーもあります。
メソッド
ITfFnSearchCandidateProvider インターフェイスには、これらのメソッドがあります。
| ITfFnSearchCandidateProvider::GetSearchCandidates IME 関連のメッセージやイベントを生成せずに、特定の文字列の変換候補の一覧を取得します。 |
| ITfFnSearchCandidateProvider::SetResult ユーザーが候補を選択したときに、履歴データを含むテキスト Service または IME を提供します。 |
解説
入力メソッド エディター (IME) で ITfFnSearchCandidateProvider インターフェイスを実装して、統合された検索エクスペリエンスを有効にします。 このインターフェイスを実装すると、IME 入力が完了する前に、特定の入力文字列に対して使用可能な IME 変換候補のセットを提供することで、意味のある結果を持つ検索を開始できます。 アプリはこのインターフェイスを使用して文字列の IME 変換を取得できるため、 ITfFnSearchCandidateProvider インターフェイスと ITfFnGetLinguisticAlternates は、 ImmGetConversionList 関数の TSF ベースの置換を提供します。 通常、IME は ITfFnGetLinguisticAlternates または ITfFnSearchCandidateProvider (またはどちらも実装しません) を実装します。
テキスト サービスの CLSID を使用して GetFunctionProvider を呼び出して、 ITfFunctionProvider インスタンスを 取得します。 ITfFunctionProvider::GetFunction メソッドの次の呼び出しを使用して、ITfFnSearchCandidateProvider インターフェイス ポインターを取得します。
ITfFunctionProvider::GetFunction(GUID_NULL, IID_ITfFnSearchCandidateProvider, &pSearchCandidate)
要件
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ctffunc.h |