手机软件开发培训第一品牌
Android 开发教程之 Android 系统
搜索对话框（浮动搜索框）的使用
前言
基础知识
创建一个搜索对话框配置文件
创建一个可用于搜索的
定义一个可搜索的
执行一个搜索
接收搜索查询
调用搜索对话框
如何给搜索框增加参数
手机软件开发培训第一品牌
当您需要在您的应用程序中提供搜索服务时，您第
一个想到的是您的搜索框要放哪呢？通过使用
的搜索框架，应用程序将显示一个自定义
搜索对话框来处理用户的搜索请求。通过一个简单
的搜索按钮或从您的应用程序中调用 ，搜索对
话框就会显示在屏幕的顶部，并会自动显示您的应
用程序图标。
本文将教你如何为你的应用程序提供一个自定义搜
索对话框。这样做，给您的用户提供一个标准化的
搜索体验，并能增加如语音搜索和搜索建议等功能。
前言
手机软件开发培训第一品牌
的搜索框架将代您管理的搜索对话框，您不需要自己去开发一个搜索框，不需
要担心要把搜索框放什么位置，也不需要担心搜索框影响您当前的界面。所有的这些工
作都由 类来为您处理（以下简称“搜索管理器”），它管理的
搜索对话框的整个生命周期，并执行您的应用程序将发送的搜索请求，返回相应的搜索
关键字。
当用户执行一个搜索，搜索管理器将使用一个专门的 把搜索查询的关键字传给您
在配置文件中配置的处理搜索结果的 。从本质上讲，所有你需要的就是一个
来接收 ，然后执行搜索，并给出结果。具体来说，你需要的做的事就包
括以下内容：
一个搜索配置
我们用个 配置文件来对搜索对话框进行配置，包括一些功能的配置，如文本框，设
置语音搜索和搜索建议中显示的提示文字等。
一个用来处理搜索请求的
这个 用来接收搜索查询的内容，然后搜索您的数据并显示搜索结果。
一种用户执行搜索的途径
默认情况下，一旦你配置了一个可搜索的 ，设备搜索键（如果有）将调用搜索
对话框。然而，你应该始终提供另一种手段，让用户可以调用搜索对话框，如在选项菜
单中的搜索按钮或其他用户界面上的按钮，因为不是所有的设备提供一个专门的搜索键。
Android 开发教程 : 基础知识
手机软件开发培训第一品牌
搜索框配置文件是一个用来配置您的应用程序中搜索框的设置的 文件，这个文件
一般命名为 ，并且必须保存在项目的 目录下。
配置文件的根节点必须为，可以有一个或多个属性。如下图所示：
!"#! !$%&'!(
) !*)*+!
,,) !-!
) !-.!(
(
上面的配置文件中，除 ) 属性外，其它都是一个搜索对话框必须的配置项，
) 是一个必须的属性，它的值为一个 资源引用，不能直接用字符串，
通常会是应用程序的名称（尽管它是一个必须的属性，但通常情况下是不显示出来的，
除非你开启了搜索建议功能）。 ) 是配置搜索框的输入提示信息，也必须
引用 中配置的字符串资源，不能直接使用字符串。
可以配置很多的属性，但大部分属性都只是在使用搜索建议和语音搜索时进行配置，尽
管如此，我们建议你一定要配置 )/ 用于提示用户需要输入的信息。
接下来，你需要把这个配置文件放到你的应用程序中。
Android 开发教程 : 创建一个搜索对话框配置文件
手机软件开发培训第一品牌
当用户从一个搜索框执行搜索时，搜索管理器
（ ）会通过 01234560.
把要搜索的内容（关键字）发送到一个可
执行搜索的 。这个 查询数据并
显示结果。
Android 开发教程 : 创建一个可用于搜索的 Activity
