©
This document uses PHP Chinese website manual Release
SearchView
版本：Android 3.1 r1
结构
继承关系
public class SearchView extends LinearLayout
java.lang.Object
android.view.View
android.view.ViewGroup
android.widget.LinearLayout
android.widget.SearchView
类概述
一个为用户提供输入搜索查询和提交请求给搜索提供者的用户界面部件。显示查询建议或结果列表，如果有的话，运行用户选择一条查询建议或结果并启动与其相关的操作。
更多信息，参见Search文档。
内部类
interface SearchView.OnCloseListener
（译者注：当用户关闭SearchView时触发的回调函数）
interface SearchView.OnQueryTextListener
当查询文本改变时的回调函数。
interface SearchView.OnSuggestionListener
在建议上选择事件时的回调接口。
XML属性
|
属性名称 |
描述 |
|
android:iconifiedByDefault |
设置SearchView的默认状态。 如果为true，在没有被使用和点击展开时它将被图形化。 |
|
android:maxWidth |
SearchView的可选择的最大宽度 |
|
android:queryHint |
当查询条件为空时显示的一个提示字符串。 |
公共方法
public CharSequence getQuery ()
返回当前文本域中的查询字符串
返回值
查询字符串
public CursorAdapter getSuggestionsAdapter ()
如果有的话，返回用于搜索建议的适配器。
返回值
查询适配器
public boolean isIconfiedByDefault ()
返回查询区域默认的图标状态。
public boolean isIconified ()
返回SearchView当前的图标状态
返回值
如果SearchView目前是图标状态，返回true，如果查询区域是完全可见的返回false
public boolean isQueryRefinementEnabled ()
返回查询优化是否是对所有的条目都起作用或者只是对特别的几个起作用
返回值
如果是对所有的条目起作用，刚返回true，否则返回false。
public boolean isSubmitButtonEnabled ()
返回当提交按钮在必须的时候是否可用或者从不显示
返回值
提交按钮在必须的时候是否自动启用
public boolean onKeyDown (int keyCode, KeyEvent event)
是否处理操作键按下事件
参数
keyCode 键入的键盘值，同时和键盘事件中的参数相同
event 输入键的完整事件记录
返回值
如果事件在这里被处理，返回true，不处理返回false
public void setIconified (boolean iconify)
图标化或者展开SearchView。当图标化时任何查询条件都被清除。这是一个临时的状态，不会重写被setIconifiedByDefault(boolean)设置的默认图标状态。如果默认的是图标化状态，则在用户关闭这个区域前都是false。如果默认的是展开状态，这里就是true，同时清除文本区域，但不关闭它。
参数
iconify true值会把SearchView收缩成一个图标，false值会展开它
返回值
查询字符串
public void setIconifiedByDefault (boolean iconified)
设置搜索栏的默认状态或者静止状态。如果是true，当被按下时，一个单一的搜索图标就会被默认显示，同时显示文本字段和其他按钮。如果默认的状态是图标，在按下关闭按钮时它就会收缩成那个状态。这个属性的改变会立即生效。
参数
iconified 搜索栏是否默认被图标化
public void setMaxWidth (int maxpixels)
以最宽的像素相看
相关的XML属性
android:maxWidth
public void setOnCloseListener (SearchView.OnCloseListener listener)
当用户关闭SearchView时设置一个监听器通知用户
参数
listener 设置用户关闭SearchView时的监听器
public void setOnQueryTextFocusChangeListener (View.OnFocusChangeListener listener)
设置当查询区域字段改变时通知用户的监听器
参数
listener 设置焦点更改时的监听器
public void setOnQueryTextListener (SearchView.OnQueryTextListener listener)
为用户在SearchView内的操作设置监听器
参数
listener 当用户在SearchView操作时比如说点击按钮或者输入查询内容时，设置接收回调的监听器对象
public void setOnSearchClickListener (View.OnClickListener listener)
设置按钮被按下时的监听器。在默认情况下当文本字段不可见时才起作用，调用setIconified(false)也可以通知这个监听器。
参数
listener 当搜索按钮被点击或者文本字段编辑取消图形化时通知监听器
public void setOnSuggestionListener (SearchView.OnSuggestionListener listener)
设置当一条搜索建议被选中或者点击的时候的监听器
参数
listener 选择搜索建议事件的监听器
public void setQuery (CharSequence query, boolean submit)
设置文本区域的一个查询字符串并选择提交和查询。
参数
query 查询字符串。代替在文本区域已经存在的查询文本
submit 是否立即提交查询或者只更新文本区域的内容
public void setQueryHint (CharSequence hint)
设置在查询文本区域的提示文本。将覆盖SearchableInfo中的任何提示。
相关XML属性
android:queryHint
参数
hint 要显示的提示文本
public void setQueryRefinementEnabled (boolean enable)
指定如果精确查询按钮是否在每条建议的旁边显示或者是否根据运营商建议中的设置在个别项目的标志决定。点击精确查询的按钮会用建议中的文本替换查询文本区域中的字段。这个标志只是在一个SearchableInfo中指定setSearchableInfo(SearchableInfo)且不使用定制的适配器时起作用。
参数
enable 如果所有的条目都有一个精确查询按钮刚为true，如果只有带精确查询标志的条目需要按钮，则为false。
参见
SUGGEST_COLUMN_FLAGS
FLAG_QUERY_REFINEMENT
public void setSearchableInfo (SearchableInfo searchable)
给SearchView设置SearchableInfo。SearchableInfo中的属性用来显示标签，提示(hints)，搜索建议，创建打开查询结果和控制其他功能比如一个声音按钮的intents。
参数
searchable 对于一个特殊的activiey或者，能从SearchManager中检索的SearchableInfo，全局的搜索提供者。
public void setSubmitButtonEnabled (boolean enabled)
当查询不为空时，显示一个提交按钮。如果SearchView被用来填充当前activity的内容，并且不会启动一个单独的activity，这里提交按钮会消失。
参数
enabled 设置为True时显示一个提交请求的按钮，当不需要请求按钮时设置为false。
public void setSuggestionsAdapter (CursorAdapter adapter)
如果你愿意，你可以设置一个定制的适配器。否则使用默认的适配器来显示和SearchableInfo相关的建议提供者的建议。
参见
setSearchableInfo(SearchableInfo)
补充
文章精选
Android ApiDemo示例解析(36)：App->Search->Invoke Search
SearchView默认扩展
SearchViewを使用してListViewのアイテムにフィルターをかける
