Android零基础入门第47节：自动完成文本框AutoCompleteTextView

上一期学习的Spinner的使用，掌握的怎么样？本期一起来学习AutoCompleteTextView的使用。

一、认识AutoCompleteTextView

AutoCompleteTextView是自动完成文本框，从EditText派生而出，实际上它也是一个文本编辑框，但它比普通编辑框多了一个功能：当用户输入一定字符之后，自动完成文本框会显示一个下拉菜单，供用户从中选择，当用户选择某个菜单项之后，AutoCompleteTextView按用户选择自动填写该文本框。

AutoCompleteTextView除了可使用EditText提供的XML属性和方法之外，还支持如下表所示的常用XML属性及相关方法。

使用AutoCompleteTextView很简单，只要为它设置一个Adapter即可，该Adapter封装了 AutoCompleteTextView预设的提示文本。

AutoCompleteTextView还派生了一个子类：MultiAutoCompleteTextView,该子类的功能与 AutoCompleteTextView基本相似，只是MultiAutoCompleteTextView允许输入多个提示项，多个提示项以分隔符分隔。MultiAutoCompleteTextView提供了 setTokenizer()方法来设置分隔符。

二、AutoCompleteTextView示例

接下来通过一个简单的示例程序来学习AutoCompleteTextView和MultiAutoCompleteTextView的使用方法。

继续使用WidgetSample工程的listviewsample模块，在app/main/res/layout/目录下创建autocomplete_textview_layout.xml文件，在其中填充如下代码片段：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:orientation="vertical"
              android:layout_width="match_parent"
              android:layout_height="match_parent">

    <!-- 定义一个自动完成文本框，指定输入一个字符后进行提示 -->
    <AutoCompleteTextView
        android:id="@+id/auto_actv"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="输入联系人姓名"
        android:completionHint="选择联系人"
        android:dropDownHorizontalOffset="10dp"
        android:completionThreshold="1"/>

    <!-- 定义一个MultiAutoCompleteTextView组件 -->
    <MultiAutoCompleteTextView
        android:id="@+id/mauto_mactv"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="输入联系人姓名，可多个分隔符分隔"
        android:completionThreshold="1"/>
</LinearLayout>

上面的界面布局文件中定义了 AutoCompleteTextView 和 MultiAutoCompleteTextView，接下来在程序中为它们绑定同一个Adapter，这意味着两个自动完成文本框的提示项完全相同，只是它们的表现行为略有差异。

新建AutoCompleteTextViewActivity.java文件，加载上面新建的布局文件，具体代码如下：

package com.jinyu.cqkxzsxy.android.listviewsample;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.ArrayAdapter;
import android.widget.AutoCompleteTextView;
import android.widget.MultiAutoCompleteTextView;

public class AutoCompleteTextViewActivity extends AppCompatActivity {
    private AutoCompleteTextView mAutoTv = null;
    private MultiAutoCompleteTextView mMultiAutoTv = null;

    // 定义字符串数组，作为提示的文本
    private String[] mContacts = new String[]{
            "test", "abc", "aaa", "aabbcc", "bac", "ok", "say", "aabbsd"
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.autocomplete_textview_layout);
        mAutoTv = (AutoCompleteTextView)findViewById(R.id.auto_actv);
        mMultiAutoTv = (MultiAutoCompleteTextView)findViewById(R.id.mauto_mactv);

        // 创建一个ArrayAdapter，封装数组
        ArrayAdapter<String> aa = new ArrayAdapter<String>(this,
                android.R.layout.simple_dropdown_item_1line, mContacts);

        // 设置Adapter
        mAutoTv.setAdapter(aa);
        mMultiAutoTv.setAdapter(aa);

        // 为MultiAutoCompleteTextView设置分隔符
        mMultiAutoTv.setTokenizer(new MultiAutoCompleteTextView.CommaTokenizer());
    }
}

上面程序代码负责为AutoCompleteTextView、MultiAutoCompleteTextView 设置同一个 Adapter，并为 MultiAutoCompleteTextView 设置了分隔符。

修改程序启动的Activity，运行程序，可以看到下图所示界面效果。