Android - 自動完成文字檢視控制元件

AutoCompleteTextView 是一種類似於 EditText 的檢視，不同之處在於它在使用者鍵入時會自動顯示完成建議列表。

建議列表顯示在下拉選單中。使用者可以選擇其中一項來替換編輯框中的內容。

AutoCompleteTextView 屬性

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

序號	屬性及說明
1	android:completionHint 這定義了在下拉選單中顯示的提示。
2	android:completionHintView 這定義了在下拉選單中顯示的提示檢視。
3	android:completionThreshold 這定義了使用者必須鍵入的字元數，之後才會在下拉選單中顯示完成建議。
4	android:dropDownAnchor 這是將自動完成下拉選單錨定到的檢視。
5	android:dropDownHeight 這指定了下拉選單的基本高度。
6	android:dropDownHorizontalOffset 下拉選單在水平方向上應偏移的畫素數。
7	android:dropDownSelector 這是下拉列表中的選擇器。
8	android:dropDownVerticalOffset 下拉選單在垂直方向上應偏移的畫素數。
9	android:dropDownWidth 這指定了下拉選單的基本寬度。
10	android:popupBackground 這設定背景。

示例

此示例將引導您完成簡單的步驟，以演示如何使用線性佈局和 AutoCompleteTextView 建立您自己的 Android 應用程式。

步驟	描述
1	您將使用 Android Studio IDE 建立一個 Android 應用程式，並將其命名為 GUIDemo3，位於包 com.example.guidemo3 下，如“Hello World 示例”章節中所述。
2	修改 src/MainActivity.java 檔案以新增點選事件。
3	修改 res/layout/activity_main.xml 檔案的預設內容以包含 Android UI 控制元件。
4	在 res/values/strings.xml 檔案中定義必要的常量
5	執行應用程式以啟動 Android 模擬器並驗證對應用程式所做的更改的結果。

以下是修改後的主活動檔案 src/com.example.guidemo3/MainActivity.java 的內容。此檔案可以包含每個基本生命週期方法。

package com.example.guidemo3;

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 autocomplete;
   
   String[] arr = { "Paries,France", "PA,United States","Parana,Brazil", 
      "Padua,Italy", "Pasadena,CA,United States"};
   
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);

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

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

      autocomplete.setThreshold(2);
      autocomplete.setAdapter(adapter);
   }
}

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

<?xml version="1.0" encoding="utf-8"?>
<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 檔案的內容如下，用於定義這些新常量：

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <string name="app_name">GUIDemo3</string>
   <string name="example_autocompletetextview">Example showing AutoCompleteTextView<
   /string>
</resources>

AndroidManifest.xml 的預設內容如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.guidemo3" >
  
      
   <application
      android:allowBackup="true"
      android:icon="@drawable/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >
      
      <activity
         android:name="com.example.guidemo3.MainActivity"
         android:label="@string/app_name" >
      
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
      
      </activity>
      
   </application>
</manifest>

讓我們嘗試執行您的 GUIDemo3 應用程式。我假設您在進行環境設定時建立了您的 AVD。要從 Android Studio 執行應用程式，請開啟專案中的一個活動檔案，然後單擊工具欄中的執行 Eclipse Run Icon 圖示。Android Studio 將應用程式安裝到您的 AVD 上並啟動它，如果您的設定和應用程式一切正常，它將顯示以下模擬器視窗：

在 AutoCompleteTextView 中鍵入“pa”後，將出現以下螢幕：

練習

我建議您嘗試以上示例，在佈局 XML 檔案以及程式設計時使用 AutoCompleteTextView 的不同屬性，以獲得 AutoCompleteTextView 不同的外觀和感覺。嘗試使其可編輯，更改字型顏色、字體系列、寬度、textSize 等，並檢視結果。您還可以嘗試在同一個活動中使用多個 AutoCompleteTextView 控制元件的以上示例。

android_user_interface_controls.htm

列印頁面