Android零基礎入門第47節：自動完成文本框AutoCompleteTextView

時間 2019-11-30

標籤 android 零基礎入門自動完成文本 autocompletetextview 欄目 Android 简体版

原文原文鏈接

上一期學習的Spinner的使用，掌握的怎麼樣？本期一塊兒來學習AutoCompleteTextView的使用。java

1、認識AutoCompleteTextView

AutoCompleteTextView是自動完成文本框，從EditText派生而出，實際上它也是一個文本編輯框，但它比普通編輯框多了一個功能：當用戶輸入必定字符以後，自動完成文本框會顯示一個下拉菜單，供用戶從中選擇，當用戶選擇某個菜單項以後，AutoCompleteTextView按用戶選擇自動填寫該文本框。android

AutoCompleteTextView除了可以使用EditText提供的XML屬性和方法以外，還支持以下表所示的經常使用XML屬性及相關方法。c#

使用AutoCompleteTextView很簡單，只要爲它設置一個Adapter便可，該Adapter封裝了 AutoCompleteTextView預設的提示文本。數組

AutoCompleteTextView還派生了一個子類：MultiAutoCompleteTextView,該子類的功能與 AutoCompleteTextView基本類似，只是MultiAutoCompleteTextView容許輸入多個提示項，多個提示項以分隔符分隔。MultiAutoCompleteTextView提供了 setTokenizer()方法來設置分隔符。微信

2、AutoCompleteTextView示例

接下來經過一個簡單的示例程序來學習AutoCompleteTextView和MultiAutoCompleteTextView的使用方法。架構

繼續使用WidgetSample工程的listviewsample模塊，在app/main/res/layout/目錄下建立autocomplete_textview_layout.xml文件，在其中填充以下代碼片斷：app

<?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，這意味着兩個自動完成文本框的提示項徹底相同，只是它們的表現行爲略有差別。ide

新建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());
    }
}