Android AutoCompleteTextView

AutoCompleteTextView是一個檢視類似於EditText，但它顯示使用者鍵入的同時自動完成建議的列表。建議列表在下拉式選單中顯示。使用者可以選擇一個專案來代替編輯框的內容。

AutoCompleteTextView 屬性

以下是相關 AutoCompleteTextView 控制元件的重要屬性。可以檢視Android官方文件的屬性和相關方法的完整列表，可以用改變這些屬性在執行時。

屬性	描述
android:completionHint	定義在下拉式選單中顯示的提示。
android:completionHintView	定義在下拉式選單中顯示的提示檢視。
android:completionThreshold	定義之前完成建議顯示在一個下拉式選單，使用者必須鍵入的字元數。
android:dropDownAnchor	這是檢視以固定自動完成下拉選單。
android:dropDownHeight	這指定下拉的基本高度。
android:dropDownHorizontalOffset	畫素 - 通過下拉水平偏移量。
android:dropDownSelector	在一個下拉選單中選擇。
android:dropDownVerticalOffset	畫素 - 通過下拉應垂直偏移量。
android:dropDownWidth	指定下拉的基本寬度。
android:popupBackground	設定背景。

例子

這個例子將通過簡單的步驟顯示如何建立自己的Android應用程式使用線性布局和AutoCompleteTextView。

Step	描述
1	使用Android Studio建立一個Android應用程式專案為：AutoCompleteTextView，並建立一個包com.yiibai.autocompletetextview。
2	修改 src/MainActivity.java 檔案，新增一個click事件。
2	修改res/layout/activity_main.xml 檔案的預設內容包括Android的UI控制元件。
3	在res/values/strings.xml中檔案定義所需的常數
4	執行該應用程式啟動Android模擬器並驗證應用程式所執行的結果。

以下是修改主活動檔案 src/com.yiibai.autocompletetextview/MainActivity.java的內容。這個檔案可以包括每個生命週期基本的方法。

package com.yiibai.autocompletetextview;

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

public class MainActivity extends Activity {
	
   AutoCompleteTextView autocompletetextview;

   String[] arr = { "MS SQL SERVER", "MySQL", "Oracle","MongoDB" };

   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);

      autocompletetextview = (AutoCompleteTextView)             
      findViewById(R.id.autoCompleteTextView1);

      ArrayAdapter adapter = new ArrayAdapter  
      (this,android.R.layout.select_dialog_item, arr);

      autocompletetextview.setThreshold(1);
      autocompletetextview.setAdapter(adapter);	
   }

   @Override
   public boolean onCreateOptionsMenu(Menu menu) {
      /* Inflate the menu; this adds items to the action bar if
      it is present */
      getMenuInflater().inflate(R.menu.main, menu);
      return true;
   }
}

下面是 res/layout/activity_main.xml 檔案的內容： 

<RelativeLayout 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: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:id="@+id/textView2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentTop="true"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="25dp"
        android:text="@string/example_autocompletetextview" /
        >

    <AutoCompleteTextView
        android:id="@+id/autoCompleteTextView1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignLeft="@+id/textView2"
        android:layout_below="@+id/textView2"
        android:layout_marginTop="54dp"
        android:ems="10" />

</RelativeLayout>

在下面檔案 res/values/strings.xml 的內容中定義兩個新的常數：