Android 自学之自动完成文本框 AutoCompleteTextView

自动完成文本框(AutoCompleteTextView)从EditText派生而出，实际上他也是一个编辑框，但他比普通的编辑框多了一个功能：当用户输入一定字符后，自动完成文本框会显示一个下拉菜单，供用户从中选择，当用户选择了某个菜单项过后，AutoCompleteTextView就会按用户选择自动填写该文本框。

AutoCompleteTextView支持的常用的XML属性和相关方法及说明

XML属性	相关方法	说明
android:completionHint	setCompletionHint(CharSequence)	设置出现在下拉菜单中的提示标题
android:completionThreshold	setThreshold(int)	设置用户至少输入几个字福才会显示提示
android:dropDownHeight	setDropDownHeight(int)	设置下拉菜单的高度
android:dropDownHorizontalOffset		设置下拉菜单与文本框之间的水平偏移，下拉菜单默认与文本框左对齐
android:dropDownVerticalOffset		设置下拉菜单与文本框之间的垂直偏移，下拉菜单默认紧跟文本框
android:dropDownWidth	setdropDownWidth(int)	设置下拉菜单的宽度
android:popupBackground	setDropDownBackgroundResource(int)	设置下拉菜单的背景

 

 

 

 

 

 

AutoCompleteTextView的使用其实很简单，只要为他设置一个Adapter，该Adapter封装了AutoCompleteTextView的预设提示文本，下面例举一个界面布局文件中包含了AutoCompleteTextView。

layout/main.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
<!-- 定义一个自动完成文本框，指定输入一个字符后进行提示 -->
<AutoCompleteTextView  
    android:id="@+id/auto"
    android:layout_width="fill_parent" 
    android:layout_height="wrap_content" 
    android:completionHint="请选择您喜欢的人："
    android:dropDownHorizontalOffset="20dp"
    android:completionThreshold="1"
    />
</LinearLayout>

com.example.autocomplete.AutoCompleteTextViewTest.java

package com.example.autocomplete;

import android.support.v7.app.ActionBarActivity;
import android.support.v7.app.ActionBar;
import android.support.v4.app.Fragment;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ArrayAdapter;
import android.widget.AutoCompleteTextView;
import android.os.Build;

public class AutoCompleteTextViewTest extends ActionBarActivity {

    //定义字符串数组，作为提示的文本
    String[] books = new String[]{
        "yangjing",
        "yangsen",
        "yanghua",
    };
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        //创建一个ArrayAdapter，封装数组
        ArrayAdapter<String> arr = new ArrayAdapter<String>(this, android.R.layout.simple_dropdown_item_1line, books);
        
        AutoCompleteTextView auto = (AutoCompleteTextView) findViewById(R.id.auto);
                
        auto.setAdapter(arr);
    }
}

效果图