完成内容,请查看http://www.zhdoc.net/android/reference/android/widget/SearchView.html
SearchView
public class SearchView
extends LinearLayout
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 using setIconifiedByDefault(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:
另请参考:
摘要
嵌套类 | |
---|---|
interface | SearchView.OnCloseListener
|
interface | SearchView.OnQueryTextListener Callbacks for changes to the query text. |
interface | SearchView.OnSuggestionListener Callback interface for selection events on suggestions. |
XML属性 | |
---|---|
android:iconifiedByDefault | SearchView的默认状态。 |
android:imeOptions | IME选项,用于设置在查询文本字段上。 |
android:inputType | 输入类型,用于设置在查询文本字段上。 |
android:maxWidth | SearchView的最大宽度(可选)。 |
android:queryHint | 在空查询字段中显示的,可选查询提示字符串。 |
继承XML属性 | |
---|---|
![]() android.widget.LinearLayout
| |
![]() android.view.ViewGroup
| |
![]() android.view.View
|
继承常量 |
---|
![]() android.widget.LinearLayout
|
![]() android.view.ViewGroup
|
![]() android.view.View
|
继承字段 |
---|
![]() 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方法 | |
---|---|
CharSequence | getAccessibilityClassName() Return the class name of this object to be used for accessibility purposes. |
int | getImeOptions() Returns the IME options set on the query text field. |
int | getInputType() Returns the input type set on the query text field. |
int | getMaxWidth() Gets the specified maximum width in pixels, if set. |
CharSequence | getQuery() Returns the query string currently in the text field. |
CharSequence | getQueryHint() Returns the hint text that will be displayed in the query text field. |
CursorAdapter | getSuggestionsAdapter() Returns the adapter used for suggestions, if any. |
boolean | isIconfiedByDefault() Returns the default iconified state of the search field. |
boolean | isIconified() Returns the current iconified state of the SearchView. |
boolean | isQueryRefinementEnabled() Returns whether query refinement is enabled for all items or only specific ones. |
boolean | isSubmitButtonEnabled() Returns whether the submit button is enabled when necessary or never displayed. |
void | onActionViewCollapsed() Called when this view is collapsed as an action view. |
void | onActionViewExpanded() Called when this view is expanded as an action view. |
boolean | onKeyDown(int keyCode, KeyEvent event) Handles the key down event for dealing with action keys. |
void | onWindowFocusChanged(boolean hasWindowFocus) Called when the window containing this view gains or loses focus. |
void | setIconified(boolean iconify) Iconifies or expands the SearchView. |
void | setIconifiedByDefault(boolean iconified) Sets the default or resting state of the search field. |
void | setImeOptions(int imeOptions) Sets the IME options on the query text field. |
void | setInputType(int inputType) Sets the input type on the query text field. |
void | setMaxWidth(int maxpixels) Makes the view at most this many pixels wide |
void | setOnCloseListener(SearchView.OnCloseListener listener) Sets a listener to inform when the user closes the SearchView. |
void | setOnQueryTextFocusChangeListener(View.OnFocusChangeListener listener) Sets a listener to inform when the focus of the query text field changes. |
void | setOnQueryTextListener(SearchView.OnQueryTextListener listener) Sets a listener for user actions within the SearchView. |
void | setOnSearchClickListener(View.OnClickListener listener) Sets a listener to inform when the search button is pressed. |
void | setOnSuggestionListener(SearchView.OnSuggestionListener listener) Sets a listener to inform when a suggestion is focused or clicked. |
void | setQuery(CharSequence query, boolean submit) Sets a query string in the text field and optionally submits the query as well. |
void | setQueryHint(CharSequence hint) Sets the hint text to display in the query text field. |
void | setQueryRefinementEnabled(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. |
void | setSearchableInfo(SearchableInfo searchable) Sets the SearchableInfo for this SearchView. |
void | setSubmitButtonEnabled(boolean enabled) Enables showing a submit button when the query is non-empty. |
void | setSuggestionsAdapter(CursorAdapter adapter) You can set a custom adapter if you wish. |
保护方法
完成内容,请查看http://www.zhdoc.net/android/reference/android/widget/SearchView.html