上一期学习的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 Auto