background image

设置语音搜索和搜索建议中显示的提示文字等。

一个用来处理搜索请求的

Activity

这个

Activity 用来接收搜索查询的内容,然后搜索您的数据并显示搜索结果。

一种用户执行搜索的途径

默认情况下,一旦你配置了一个可搜索的

Activity,设备搜索键(如果有)将调用搜索

对话框。然而,你应该始终提供另一种手段,让用户可以调用搜索对话框,如在选项菜单中
的搜索按钮或其他用户界面上的按钮,因为不是所有的设备提供一个专门的搜索键。

创建一个搜索对话框配置文件

搜索框配置文件是一个用来配置您的应用程序中搜索框的设置的

XML 文件,这个文

件一般命名为

searchable.xml,并且必须保存在项目的 res/xml/目录下。

配置文件的根节点必须为,可以有一个或多个属性。如下图所示:

1

xml 

version="1.0" 

encoding="utf-8"?> 

<searchable 

xmlns:android="http://schemas.android.com/apk/res/android" 

2

    android:label="@string/searchLabel" android:hint="@string/searchHint"> searchable> 

3

 

上面的配置文件中,除

android:hint 属性外,其它都是一个搜索对话框必须的配置项,

android:label 是一个必须的属性,它的值为一个 string 资源引用,不能直接用字符串,通常
会是应用程序的名称(尽管它是一个必须的属性,但通常情况下是不显示出来的,除非你
开启了搜索建议功能)。

android:hint 是配置搜索框的输入提示信息,也必须引用 string.xml

中配置的字符串资源,不能直接使用字符串。

可以配置很多的属性,但大部分属性都只是在使用搜索建议和语音搜索时进行配置,

尽管如此,我们建议你一定要配置

android:hint,用于提示用户需要输入的信息。

接下来,你需要把这个配置文件放到你的应用程序中。

创建一个可用于搜索的

Activity

当 用 户 从 一 个 搜 索 框 执 行 搜 索 时 , 搜 索 管 理 器 (

Search  Manager ) 会 通 过

ACTION_SEARCH Intent 把要搜索的内容(关键字)发送到一个可执行搜索的 Activity。这

Acitivity 查询数据并显示结果。

定义一个可搜索的

Activity

如果你还没有准备好,那么就创建一个用来执行搜索的

Activity,声明它可以响应

ACTION_SEARCH Intent ,并且增加搜索框配置信息。为此,你需要添加一个元素和一个