Android7.0中文API -- SearchView

完成内容，请查看http://www.zhdoc.net/android/reference/android/widget/SearchView.html

SearchView

public class SearchView
extendsLinearLayout implements CollapsibleActionView

java.lang.Object   ↳android.view.View    ↳android.view.ViewGroup     ↳android.widget.LinearLayout      ↳android.widget.SearchView

---

A widget that provides a user interface for the user to enter a search query and submit a request to a search provider. Shows a list of query suggestions or results, if available, and allows the user to pick a suggestion or result to launch into.
一个widget，其提供了一个用户界面，用户可以输入一个搜索词条，并向一个search provider提交一个请求。显示查询建议词条的列表或结果，如果可用，则允许用户从中选取一个建议词条或结果，并使用。

When the SearchView is used in an ActionBar as an action view for a collapsible menu item, it needs to be set to iconified by default usingsetIconifiedByDefault(true). This is the default, so nothing needs to be done.
当在ActionBar中使用SearchView作为可折叠菜单项的操作视图时，需要将其设置为默认使用setIconifiedByDefault(true)来将其设置为图标化。这是默认的，因此没有什么需要做。

If you want the search field to always be visible, then call setIconifiedByDefault(false).
如果你需要始终显示搜索字段，则调用setIconifiedByDefault(false)。

开发者指南

For information about using SearchView, read the Search developer guide.
关于使用SearchView的更多信息，请阅读Search开发者指南。

See also:
另请参考：

• SHOW_AS_ACTION_COLLAPSE_ACTION_VIEW

摘要

---

嵌套类

interfaceSearchView.OnCloseListener

 

interfaceSearchView.OnQueryTextListener

Callbacks for changes to the query text. 
修改查询文本的回调。 

interfaceSearchView.OnSuggestionListener

Callback interface for selection events on suggestions. 
在建议词条上选择事件的回调接口。 

XML属性

android:iconifiedByDefaultSearchView的默认状态。 android:imeOptionsIME选项，用于设置在查询文本字段上。 android:inputType输入类型，用于设置在查询文本字段上。 android:maxWidthSearchView的最大宽度（可选）。 android:queryHint在空查询字段中显示的，可选查询提示字符串。 

继承XML属性

From class android.widget.LinearLayout

From class android.view.ViewGroup

From class android.view.View

继承常量

From class android.widget.LinearLayout

From class android.view.ViewGroup

From class android.view.View

继承字段

From class android.view.View

Public构造方法

SearchView(Context context) SearchView(Context context, AttributeSet attrs) SearchView(Context context, AttributeSet attrs, int defStyleAttr) SearchView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)

Public方法

CharSequencegetAccessibilityClassName()

Return the class name of this object to be used for accessibility purposes.
返回此对象的类名，用于辅助功能目的。

intgetImeOptions()

Returns the IME options set on the query text field.
返回IME选项，其用于设置在查询文本字段上。

intgetInputType()

Returns the input type set on the query text field.
返回输入类型，其用于设置在查询文本字段上。

intgetMaxWidth()

Gets the specified maximum width in pixels, if set.
获取最大宽度（以像素为单位），如果设置了话。

CharSequencegetQuery()

Returns the query string currently in the text field.
返回文本字段中当前的查询字符串。

CharSequencegetQueryHint()

Returns the hint text that will be displayed in the query text field.
返回提示文本，其显示在查询文本字段中。

CursorAdaptergetSuggestionsAdapter()

Returns the adapter used for suggestions, if any.
返回用于建议的适配器，如果有的话。

booleanisIconfiedByDefault()

Returns the default iconified state of the search field.
返回默认搜索字段的图标化状态。

booleanisIconified()

Returns the current iconified state of the SearchView.
返回当前SearchView的图标化状态。

booleanisQueryRefinementEnabled()

Returns whether query refinement is enabled for all items or only specific ones.
返回是否为所有的项或仅指定的一项使能查询优化。

booleanisSubmitButtonEnabled()

Returns whether the submit button is enabled when necessary or never displayed.
返回必要时是否显示提交按钮。

voidonActionViewCollapsed()

Called when this view is collapsed as an action view.
当此视图作为一个操作视图折叠时调用。

voidonActionViewExpanded()

Called when this view is expanded as an action view.
当此视图作为一个操作视图展开时调用。

booleanonKeyDown(int keyCode,KeyEvent event)

Handles the key down event for dealing with action keys.
处理操作键的按钮按下事件。

voidonWindowFocusChanged(boolean hasWindowFocus)

Called when the window containing this view gains or loses focus.
当包含此视图的窗口获得或失去焦点时，调用此方法。

voidsetIconified(boolean iconify)

Iconifies or expands the SearchView.
图标化或展开SearchView。

voidsetIconifiedByDefault(boolean iconified)

Sets the default or resting state of the search field.
设置搜索字段的默认状态或休眠状态。

voidsetImeOptions(int imeOptions)

Sets the IME options on the query text field.
设置IME选项，其用于查询文本字段上。

voidsetInputType(int inputType)

Sets the input type on the query text field.
设置输入类型，其用于在查询文本字段上。

voidsetMaxWidth(int maxpixels)

Makes the view at most this many pixels wide
设置视图显示的最大宽度（单位是字符）。

voidsetOnCloseListener(SearchView.OnCloseListener listener)

Sets a listener to inform when the user closes the SearchView.
设置一个监听器，当用户关闭SearchView时被通知。

voidsetOnQueryTextFocusChangeListener(View.OnFocusChangeListener listener)

Sets a listener to inform when the focus of the query text field changes.
设置一个监听器，当查询文本字段的焦点发生改变时被通知。

voidsetOnQueryTextListener(SearchView.OnQueryTextListener listener)

Sets a listener for user actions within the SearchView.
设置一个监听器，当用户在SearchView内操作时被通知。

voidsetOnSearchClickListener(View.OnClickListener listener)

Sets a listener to inform when the search button is pressed.
设置一个监听器，当按下搜索按钮时被通知。

voidsetOnSuggestionListener(SearchView.OnSuggestionListener listener)

Sets a listener to inform when a suggestion is focused or clicked.
设置一个监听器，当一个建议词条被设置为焦点或点击时被通知。

voidsetQuery(CharSequence query, boolean submit)

Sets a query string in the text field and optionally submits the query as well.
在文本字段中设置一个查询字符串，并可以选择提交查询。

voidsetQueryHint(CharSequence hint)

Sets the hint text to display in the query text field.
设置提示文本，其显示在查询文本字段中。

voidsetQueryRefinementEnabled(boolean enable)

Specifies if a query refinement button should be displayed alongside each suggestion or if it should depend on the flags set in the individual items retrieved from the suggestions provider.
指定查询优化按钮是否应该与每个建议词条一起显示，或者是否应该依赖于从建议provider中取回到的个别项中设置的标志。

voidsetSearchableInfo(SearchableInfo searchable)

Sets the SearchableInfo for this SearchView.
设置此SearchView的SearchableInfo。

voidsetSubmitButtonEnabled(boolean enabled)

Enables showing a submit button when the query is non-empty.
当有查询词条的时候，是否显示一个提交按钮。

voidsetSuggestionsAdapter(CursorAdapter adapter)

You can set a custom adapter if you wish.
如果需要，你可以设置一个自定义的适配器。

保护方法

完成内容，请查看http://www.zhdoc.net/android/reference/android/widget/SearchView.html