在Android应用中SearchView常与Menu配合使用,以在应用的操作栏(通常是应用栏或工具栏)中提供搜索功能。
步骤:
res \ menu \ xxx.xml
可不替换
清单文件中 android:theme="MyTheme"
Toolbar toolbar=findViewById(R.id.toolBar);
setSupportActionBar(toolbar);
public class MainActivity extends AppCompatActivity {
protected void onCreate(Bundle savedInstanceState) {
... ...
}
public boolean onCreateOptionsMenu(Menu menu) {
//创建菜单时调用
//填充菜单
getMenuInflater().inflate(R.menu.overflowmenu,menu);
return true;
}
public boolean onOptionsItemSelected(MenuItem item) {
//点击菜单项调用
return true;
}
public boolean onMenuOpened(int featureId, Menu menu) {
//打开菜单时调用
//可在此添加自定义方法,使列表项显示icon图标
return super.onMenuOpened(featureId, menu);
}
}
public boolean onCreateOptionsMenu(Menu menu) {
//创建菜单时调用
//创建菜单栏
//填充菜单
getMenuInflater().inflate(R.menu.overflowmenu,menu);
//获取指定菜单项
MenuItem menuItem=menu.findItem(R.id.searchItem);
//获取搜索框
SearchView searchView= (SearchView) menuItem.getActionView();
//设置默认为图标化
searchView.setIconifiedByDefault(true);
//设置提示字符串
searchView.setQueryHint("请输入关键字");
//设置提交按钮有效
searchView.setSubmitButtonEnabled(true);
//设置键盘信息-回车键变搜索键
searchView.setImeOptions(EditorInfo.IME_ACTION_SEARCH);
//设置查询文本监听器-输入文本时出现建议
searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
public boolean onQueryTextSubmit(String query) {
//查询提交时调用
return true;
}
public boolean onQueryTextChange(String newText) {
//查询文本变化时调用
//String newText = searchView.getQuery().toString();
//获取Cursor(通过搜索框内容newText模糊查询的结果)
//请注意作为SimpleCursorAdapter参数的Cursor中必须包含列名为 _id 的列
Cursor cursor= ~ ;
//设置建议适配器
CursorAdapter suggestionAdapter = new SimpleCursorAdapter(
MainActivity.this, //环境
android.R.layout.simple_list_item_1, // 使用默认的建议项布局
cursor, // 这里传入Cursor数据源(存储了N个建议String)
new String[] { QueryUtil.column_name }, // 数据源中的建议文本列
new int[] { android.R.id.text1 }, // 建议项视图中的文本视图ID
0
);
searchView.setSuggestionsAdapter(suggestionAdapter);
return true;
}
});
//设置建议监听器-点击建议自动补全
searchView.setOnSuggestionListener(new SearchView.OnSuggestionListener() {
public boolean onSuggestionSelect(int position) {
//建议选中时调用
return true;
}
@SuppressLint("Range")
public boolean onSuggestionClick(int position) {
//建议点击时调用
CursorAdapter suggestionAdapter=searchView.getSuggestionsAdapter();
Cursor cursor = suggestionAdapter.getCursor();
if (cursor != null) {
cursor.moveToPosition(position);//移动到指定position
String suggestion = cursor.getString(cursor.getColumnIndex(QueryUtil.column_name));// 获取建议文本列的索引的String值
searchView.setQuery(suggestion, true); // 自动填充SearchView
}
return true;
}
});
return true;
}
请注意作为SimpleCursorAdapter参数的Cursor中必须包含列名为 _id 的列
setIconifiedByDefault(boolean iconify) 设置 SearchView
是否默认时处于图标化状态。
setIconified(boolean iconify) 设置 SearchView
是否处于图标化状态(收缩状态)。如果设置为 true
,则 SearchView
将显示为一个图标,而不是一个扩展的搜索框。
isIconified() 检查 SearchView
是否处于图标化状态。
setQueryHint(String hint) 设置搜索框中的提示文本。
setSubmitButtonEnabled(boolean enabled) 启用或禁用搜索框中的提交按钮。启用后,用户可以点击提交按钮执行搜索操作。
setImeOptions( EditorInfo.IME_ACTION_SEARCH ) 设置键盘信息(回车键变搜索键)。
setOnQueryTextListener(OnQueryTextListener listener) 设置一个查询文本监听器,可以通过该监听器捕获文本变化(onQueryTextChange)及提交查询操作(onQueryTextSubmit)事件。实现其中的onQueryTextChange方法,在文本变化时为搜索框设置建议适配器(setSuggestionsAdapter);使其在文本变化时显示建议(列表)。
setSuggestionsAdapter(CursorAdapter adapter) 设置搜索建议的适配器,用于提供搜索建议(列表)。
setOnSuggestionListener(OnSuggestionListener listener) 设置建议监听器,可以通过该监听器捕获建议选中(onSuggestionSelect)及建议点击(onSuggestionClick)事件。实现其中的onSuggestionClick方法,在点击建议时为搜索框设置搜索内容及是否提交(setQuery);使其在点击建议时自动补全并提交查询。
setQuery(CharSequence query, boolean submit) 设置查询内容,放入搜索框中;第一个参数为查询文本,第二个参数为是否自动提交搜索。
getQuery() 获取当前搜索框中的查询文本。
setFocusable(boolean focusable) 设置 SearchView
是否可以获得焦点。
setOnQueryTextFocusChangeListener(View.OnFocusChangeListener listener) 设置焦点变化监听器,以便在焦点状态变化时进行相应操作。
setOnCloseListener(OnCloseListener listener) 设置一个关闭事件的监听器,当用户关闭 SearchView
时触发。