到顶部
Android API
公众的

搜索最近的建议

延伸对象
java.lang.Object(java.lang.对象)
   ↳ android.provider。搜索最近的建议

课程概述

这是一个实用程序类,提供对SearchRecentSuggestionsProvider(搜索近期建议提供商).

与一些实用程序类不同,这个类必须实例化并正确初始化,这样可以将其配置为使用您创建的搜索建议提供程序进行操作。

通常,每次收到传入的操作_搜索意图。记录每个传入查询如下:

SearchSuggestions suggestions=新的搜索建议(this,我的建议提供商。授权,MySuggestionsProvider。模式);suggestions.saveRecentQuery(queryString,null);

有关工作示例,请参阅中的SearchSuggestionSampleProvider和SearchQueryResults示例/ApiDemos/app。

开发人员指南

有关在应用程序中使用搜索建议的信息,请阅读添加最近的查询建议开发人员指南。

总结

常量
整数 查询_项目_日期_索引 索引到提供的查询投影。
整数 查询_项目_显示1_INDEX 索引到提供的查询投影。
整数 查询_投影_显示2_索引 索引到提供的查询投影。
整数 查询_投影_查询_索引 索引到提供的查询投影。
领域
公众的静止的最终的字符串[] 查询_项目_1行 这是可用于查看保存的查询的数据库投影,当配置为单线操作。
公众的静止的最终的字符串[] 查询_项目_线路 这是可用于查看保存的查询的数据库投影,当配置为双线操作。
公共建筑商
搜索最近的建议(上下文上下文,字符串权限,int模式)
虽然提供者实用程序类通常是静态的,但必须构造这个类因为它需要使用您在SearchRecentSuggestionsProvider(搜索近期建议提供商).
公共方法
空隙 清除历史记录()
完全删除历史记录。
空隙 saveRecentQuery(字符串查询字符串,字符串第2行)
将查询添加到最近的查询列表中。
受保护的方法
空隙 截断历史记录(内容解析器cr,int maxEntries)
减少历史表的长度,以防止其变得过大。
[展开]
继承的方法
来自班级java.lang.Object(java.lang.对象)

常量

公众静态最终的整数查询_项目_日期_索引

索引到提供的查询投影。用于Cursor.update方法。

常量值: 1(0x00000001)

公众静态最终的整数查询_项目_显示_索引

索引到提供的查询投影。用于Cursor.update方法。

常量值: (0x00000003)

公众静态最终的整数查询_投影_显示2_索引

索引到提供的查询投影。用于Cursor.update方法。

常量值: 4(0x00000004)

公众静态最终的整数查询_投影_查询_索引

索引到提供的查询投影。用于Cursor.update方法。

常量值: 2(0x00000002)

领域

公众静态最终的字符串[] 查询_项目_1行

这是可用于查看保存的查询的数据库投影,当配置为单线操作。

公众静态最终的字符串[] 查询_项目_线路

这是可用于查看保存的查询的数据库投影,当配置为双线操作。

公共建筑商

公众的 搜索最近的建议 (上下文上下文,字符串权限,int模式)

虽然提供者实用程序类通常是静态的,但必须构造这个类因为它需要使用您在SearchRecentSuggestionsProvider(搜索近期建议提供商).

参数
权威 这必须与您在舱单中声明的权限相匹配。
模式 您可以在此处使用模式标志来确定数据库。请注意,此值不应随运行而变化,因为当它发生变化时,您的建议数据库可能会被删除。

公共方法

公众空隙 清除历史记录 ()

完全删除历史记录。使用此调用实现“清除历史记录”UI。任何基于以前的操作(例如最近的查询、查看的页面/项目等)应为用户提供清除历史。如果用户不希望使用最近的要由设备的其他用户(通过建议)重放的搜索。

公众空隙 保存记录查询 (字符串查询字符串,字符串第2行)

将查询添加到最近的查询列表。立即返回,执行保存在背景中。

参数
查询字符串 用户键入的字符串。此字符串将显示为建议,如果用户单击该建议,此字符串将发送到您的可搜索活动(作为新的搜索查询)。
第2行 如果您已将最近的建议提供程序配置为数据库_模式_2LINES,你可以在这里传递第二行文本。它将以较小的字体显示在主屏幕下方建议。键入时,列表中将显示每行文本中的匹配项。如果您没有配置双线模式,或者给定的建议没有要显示的其他文本,可以在此处传递null。

受保护的方法

受保护的空隙 截断历史记录 (内容解析器cr,int maxEntries)

减少历史表的长度,以防止其变得过大。

参数
内容解析器的方便副本。
maxEntries(最大条目数) 表中保留的最大条目数。0表示删除所有条目。