Android--UI之AutoCompleteTextView

前言

之前讲过EditText，有兴趣的朋友可以看一下。这篇博客主要说明的是自动完成文本框，它实际上也是一个文本编辑框，可以理解为对EditText功能的扩展，它对输入的内容可以进行提示并且自动完成。本文会讲解常用属性设置，以及如何向AutoCompleteTextView增加提示数据，最后将使用一个demo演示一下。

 

说明

自动完成文本框（AutoCompleteTextView），可以从官方文档上看出，是从EditText继承而来，所以它实际上也是一个文本编辑框，只是多了一个自动提示输入补全的功能。功能类似于：当用户输入一定字符之后，自动完成文本框会显示一个下拉列表，供用户从中选择，当用户选择某个菜单项之后，AutoCompleteTextView会按照的选择自动填写该文本框。

 

常用属性

因为是继承自EditText，所以AutoCompleteTextView除了可以使提供用Edit的属性和方法之外，还支持如下一些特殊的属性及方法，这里只介绍一些常用的，具体请参见官方文档：

• android:completionHint/setCompletionHint(CharSequence)：设置出现下拉列表的提示标题。
• android:completionTjreshold/setThreshold(int):设置至少输入几个字符才会显示提示。
• android:dropDownHeight/setDropHeight(int):设置下拉列表的高度。
• android:dropDownWidth/setDropWidth(int):设置下拉列表的宽度。
• android:popupBackground/setDropDownbackgroundResource(int):设置下拉列表的背景。

 

填充选择数据

在Android程序中，为了展示数据，通常会用到一个Adapter的接口。没错，这是一个接口，是连接后端数据和前端显示的桥梁，是data souce和UI（View）之间一个重要的纽带。下图展示了Adapter在Android程序中的关系：

对于Adapter，它是一个接口，Android为其声明了各种实现类，对于在AutoCompleteTextView控件中，一般使用ArrayAdapter<T>即可完成功能，对于一些其他实现类的应用场景，以后会慢慢介绍。

ArrayAdapter<T>继承自一个抽象类BaseAdapter，而这个抽象类实现了Adapter接口，所以继承关系应该是：Adapter→BaseAdater→ArrayAdapter<T>。

从名字上可以看出，ArrayAdapter<T>是以一个数组的形式去存储数据的，它也确实是这么做的，并且可以传递一个数组对其进行构造。所以我们只需要填充一个数组对象，就完成ArrayAdapter对象的初始化工作，在把得到的ArrayAdapter对象传递给AutoCompleteTextView控件，即可对其进行选择数据设置。

MultiAutoCompleteTextView

既然讲到了AutoCompleteTextView，那就顺带讲一下MultiAutoCompleteTextView，它继承自AutoCompleteTextView。新扩展的功能是：可以进行多次提示，并且每次指定完成的内容通过符号进行分隔显示。使用MultiAutoCompleteTextView必须实现一个MultiAutoCompleteTextView.Tokenizer接口，用于声明用于选项与选项之间分隔的符号，一般如不特殊指定，可以使用Android为我们提供的实现类MultiAutoCompleteTextView.CommaTokenizer，它设定使用英文逗号","进行分隔选项。

 

demo

下面新建一个Android项目来演示一下上面讲到的内容，提供两个输入框，AutoCompleteTextView和MultiAutoCompleteTextView，然后对其进行“著名城市”的数据填充，并且进行演示，详细的在代码中已经注释，这里不再进行单独讲解。

布局文件代码：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context=".MainActivity" >
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/autoText" />
    <!-- 声明一个AutoCompleteTextView控件，设定其下拉框标题为“Famous Citi” 并且输入一个字符开始提示-->
    <AutoCompleteTextView
        android:id="@+id/autotext"
        android:completionHint="Famous Citi"
        android:completionThreshold="1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/multiautoText"
    />
    <MultiAutoCompleteTextView 
        android:id="@+id/multiautotext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>
</LinearLayout>

 

实现Java代码：

package com.bgxt.autocomplettextviewdemo;

import android.os.Bundle;
import android.app.Activity;
import android.view.Menu;
import android.widget.ArrayAdapter;
import android.widget.AutoCompleteTextView;
import android.widget.MultiAutoCompleteTextView;

public class MainActivity extends Activity {
    private AutoCompleteTextView autotext;
    private MultiAutoCompleteTextView multiautotext;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        //获取布局文件中的两个控件对象
        autotext=(AutoCompleteTextView)findViewById(R.id.autotext);
        multiautotext=(MultiAutoCompleteTextView)findViewById(R.id.multiautotext);        
        
        //设置数据源
        String[] autoStrings=new String[]{"New York","Tokyo","beijing","london","Seoul Special","Los Angeles"};
        //设置ArrayAdapter，并且设定以单行下拉列表风格展示（第二个参数设定）。
        ArrayAdapter<String> adapter=new ArrayAdapter<String>(MainActivity.this, 
android.R.layout.simple_dropdown_item_1line, autoStrings);
        //设置AutoCompleteTextView的Adapter
        autotext.setAdapter(adapter);
        
        //设置MultiAutoCompleteTextView的Adapter
        multiautotext.setAdapter(adapter);
        //设定选项间隔使用逗号分隔。
        multiautotext.setTokenizer(new MultiAutoCompleteTextView.CommaTokenizer());
    }
}

实现效果：

  实例代码下载

总结

以上就讲解了一下AutoCompleteTextView和MultiAutoCompleteTextView的简单使用，虽然只是一个辅助的功能，但是可以增加更好的用户体验，用户友好对于移动开发是必不可少的。