SearchView搜索框的功能和用法

SearchView是搜索框组件，它可以让用户在文本框输入文字，并允许通过监听用户输入，当用户输入完成后提交搜索时，可通过监听器执行实际的搜索。
setIconifiedByDefault（）：该搜索框默认是否自动缩小为图标
setSubmitButtonEnabled（）：设置是否显示搜索按钮
setQueryHint（）：设置搜索框内默认显示的文本
setOnQueryTextListener():为该searchview组件设置监听事件
XML:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context=".MainActivity">
    //定义一个searchView
    <SearchView
        android:id="@+id/sv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>
        //为searchView定义自动完成listView
        <ListView
            android:id="@+id/lv"
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1"/>

</LinearLayout>

布局如下：

image.png

listView为searchView组件显示完成列表
Activity：

package com.example.myapplication;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.text.TextUtils;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.SearchView;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
   private String[] mStrings=new String[]{"aaaa","bbbb","cccc"};
   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_main);
       final ListView lv=findViewById(R.id.lv);
       lv.setAdapter(new ArrayAdapter(this,android.R.layout.simple_list_item_1,mStrings));
       //设置listView启用过滤
       lv.setTextFilterEnabled(true);
       SearchView sv=findViewById(R.id.sv);
       //设置searchview默认是否自动缩小图标
       sv.setIconifiedByDefault(false);
       //设置searchview
       sv.setSubmitButtonEnabled(true);
       //设置该searchview内默认显示的提示文本
       sv.setQueryHint("查找");
       //为该searchview组件设置监听事件
       sv.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
           @Override
           public boolean onQueryTextChange(String newText) {
               //如果newtext不是长度为0的字符串
               if (TextUtils.isEmpty(newText))
               {
                   //清除listview的过滤
                   lv.clearTextFilter();
               }else {
                   //使用用户输入内容对listview的列表项进行过滤
                   lv.setFilterText(newText);
               }
               return true;
           }
           //单击搜索按钮时激发该方法
           public boolean onQueryTextSubmit(String query) {
               //实际应用中应该在该方法内执行实际查询
               //此处仅使用Toast显示用户查询的内容
               Toast.makeText(MainActivity.this,"您的选择是："+query,Toast.LENGTH_SHORT).show();
               return false;
           }
       });
   }
}

示例效果：

2.gif