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的簡單使用，雖然只是一個輔助的功能，但是可以增加更好的用戶體驗，用戶友好對於移動開發是必不可少的。

　　請支持原創，尊重原創，轉載請注明出處。謝謝。