SearchView搜索框的功能与用法

SearchView的功能以及用法

使用SearchView，可以让用户在文本框内输入文字，并允许通过监听器监控用户的输入，当用户输入完成后提交搜索时，也可以通过监听器执行实际的搜索。

---

使用SearchView时可使用如下常用方法：
1.setIconifiedByDefault(boolean iconified):设置该搜索框默认是否自动缩小为图标。
2.setSubmitButtonEnabled(boolean enabled):设置是否显示搜索按钮。
3.setQueryHint(CharSequence hint):设置搜索框内默认显示的提示文本。
4.setOnQueryTextListener(SearchView.OnQueryTextListener listener):为该搜索框设置事件监听器。
如果为SearchView增加一个配套的ListView，则可以为SearchView增加自动完成的功能。如下实例示范了SearchView的功能与用法：

---

### 实例：搜索

在layout下的activitymain.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=".Main4Activity">
<!--    定义SearchView组件-->
    <SearchView
        android:id="@+id/search"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>
<!--    为SearchView定义自动完成的ListView组件-->
    <ListView
        android:id="@+id/list"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"/>

</LinearLayout>

在MainActivity.java下：

package com.example.test04;

import androidx.appcompat.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 Main4Activity extends AppCompatActivity {
//    自动完成列表
    private String[] strings = new String[]{"111","222","333"};
    private ListView list;
    private SearchView search;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main4);
        list=findViewById(R.id.list);
        search=findViewById(R.id.search);
        list.setAdapter(new ArrayAdapter(this,android.R.layout.simple_list_item_1,
                strings));
//        设置ListView启动过滤
        list.setTextFilterEnabled(true);
//        设置该SearchView默认是否自动缩小为图标
        search.setIconifiedByDefault(false);
//        设置该SearchView显示搜索图标
        search.setSubmitButtonEnabled(true);
//        设置该SearchView内默认显示的搜索文字
        search.setQueryHint("查找");
//        为SearchView组件设置事件的监听器
        search.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
//            单击搜索按钮时激发该方法
            @Override
            public boolean onQueryTextSubmit(String query) {
//                实际应用中应该在该方法内执行实际查询
//                此处仅使用Toast显示用户输入的查询内容
                Toast.makeText(Main4Activity.this,"您选择的是："+query,
                        Toast.LENGTH_SHORT).show();
                return false;
            }
//            用户输入时激发该方法
            @Override
            public boolean onQueryTextChange(String newText) {
//                如果newText不是长度为0的字符串
                if (TextUtils.isEmpty(newText)){
//                    清除ListView的过滤
                    list.clearTextFilter();
                }else {
//                    使用用户输入的内容对ListView的列表项进行过滤
                    list.setFilterText(newText);
                }
                return true;
            }
        });
    }
}

最后，如果喜欢这篇文章的小伙伴点赞加关注哦，爱点赞的人运气永远都不会太差。