ITfFnSearchCandidateProvider 接口 (ctffunc.h)

在输入法编辑器中启用集成搜索体验, (输入法) 。

继承

ITfFnSearchCandidateProvider 接口继承自 IUnknown 接口。 ITfFnSearchCandidateProvider 还具有以下类型的成员:

方法

ITfFnSearchCandidateProvider 接口包含以下方法。

 
ITfFnSearchCandidateProvider::GetSearchCandidates

获取给定字符串的转换候选项列表,而不生成任何与 IME 相关的消息或事件。
ITfFnSearchCandidateProvider::SetResult

当用户选择候选项时,为文本服务或输入法提供历史记录数据。

注解

在输入法编辑器中实现 ITfFnSearchCandidateProvider 接口, (输入法) 启用集成搜索体验。 实现此接口可为给定输入字符串提供一组可能的 IME 转换候选项,使具有有意义结果的搜索能够在 IME 输入完成之前开始。 应用可以使用此接口获取字符串的 IME 转换,因此 ITfFnSearchCandidateProvider 接口以及 ITfFnGetLinguisticAlternatesImmGetConversionList 函数提供了基于 TSF 的替换。 通常,IME 实现 ITfFnGetLinguisticAlternatesITfFnSearchCandidateProvider (,或者两者都不) 。

使用文本服务的 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