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

関連項目

GetFunction

GetFunctionProvider

IUnknown

SearchPaneQueryLinguisticDetails