实例讲解Android中的AutoCompleteTextView自动补全组件

AutoCompleteTextView是一个具有自动补全功能的EditView，当用户输入数据后，AutoCompleteTextView就会将用户输入的数据与他自己的adapter中的数据对比，如果用户数据与adapter中的某条数据的开始部分完全匹配，那么adapter中的这条数据就会出现在下拉提示框中。

其常用属性定义如下

<AutoCompleteTextView
 android:id="@+id/mp002_top_place_input"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 android:completionThreshold="1"
 android:layout_marginTop="5dp" >
</AutoCompleteTextView>

其中android:completionThreshold定义了从第几个字符开始显示候补列表。
默认值为2。

使用例：

AutoCompleteTextView mPlace = (AutoCompleteTextView)findViewById(R.id.mp002_top_place_input);
ArrayList<String> result = new ArrayList<String>();
result.add("1111111");
result.add("1222222");
mPlace.setAdapter(new ArrayAdapter<String>(
  MP002TopActivity.this,
  android.R.layout.simple_dropdown_item_1line,
  result)
);

 
局限性是completionThreshold设定的最小值是1，
小于1的情况下，会默认变成1。
 
所以要在不输入任何字符的条件下显示候补列表，
就必须重载AutoCompleteTextView这个控件。
 

public class MyAutoCompleteTextView extends AutoCompleteTextView{
public MyAutoCompleteTextView(Context context) {
 super(context);
}
public MyAutoCompleteTextView(Context context, AttributeSet attrs) {
 super(context, attrs);
}
public MyAutoCompleteTextView(Context context, AttributeSet attrs, int defStyle) {
 super(context, attrs, defStyle);
}
@Override
public boolean enoughToFilter() {
 return true;
}
@Override
protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
 super.onFocusChanged(focused, direction, previouslyFocusedRect);
 performFiltering(getText(), KeyEvent.KEYCODE_UNKNOWN);
}
}

enoughToFilter()是判断输入文字列长度是否满足现实候补列表的要求的方法。
onFocusChanged()是当控件获得焦点时让其显示候补列表。

使用AutoCompleteTextView实现邮箱地址补全
例如：adapter中有3条数据“abc”，“hjk”，“abd”，而用户输入“ab”，那么下拉提示框中将会出现“abc”和“abd”。（AutoCompleteTextView默认在用户输入两个字符之后才提示，可以通过setThreshold(1)来将它设置为用户输入1个字符后就开始提示）

AutoCompleteTextView在匹配用户输入数据时，会调用performFiltering方法，将用户数据传入，并调用adapter的filter来处理。

因为当用户选中下拉列表中的某一项时，AutoCompleteTextView会使用该项对应的adapter中的数据来填充文本域，这与我们这边的需求不太相同，因为我们的adapter中只有类似于“@163.com”的email地址后缀，下拉框中的数据是我们将用户输入和adapter中的数据拼接而成的。因此我们需要重写replaceText方法，以使AutoCompleteTextView来在用户选中某一项时，用我们指定的文本来填充文本域。

然后我们需要为AutoCompleteTextView设置OnFocusChangeListener来在用户移开焦点后，进行email地址格式检查，并且在再次获得焦点后重启提示功能。

代码如下：（EmailAutoCompleteTextView.java）

public class EmailAutoCompleteTextView extends AutoCompleteTextView {
 private static final String TAG = "EmailAutoCompleteTextView";

private String[] emailSufixs = new String[] { "@163.com",
   "@gmail.com", "@hotmail.com" };

public EmailAutoCompleteTextView(Context context) {
   super(context);
   init(context);
 }

public EmailAutoCompleteTextView(Context context, AttributeSet attrs) {
   super(context, attrs);
   init(context);
 }

public EmailAutoCompleteTextView(Context context, AttributeSet attrs,
     int defStyle) {
   super(context, attrs, defStyle);
   init(context);
 }

public void setAdapterString(String[] es) {
   if(es != null && es.length > 0)
     this.emailSufixs = es;
 }

private void init(final Context context) {
   //adapter中使用默认的emailSufixs中的数据，可以通过setAdapterString来更改
   this.setAdapter(new EmailAutoCompleteAdapter(context, R.layout.auto_complete_item, emailSufixs));

//使得在输入1个字符之后便开启自动完成
   this.setThreshold(1);

this.setOnFocusChangeListener(new OnFocusChangeListener() {

@Override
     public void onFocusChange(View v, boolean hasFocus) {
       if(hasFocus) {
         String text = EmailAutoCompleteTextView.this.getText().toString();
         //当该文本域重新获得焦点后，重启自动完成
         if(!"".equals(text))
           performFiltering(text, 0);
       } else {
         //当文本域丢失焦点后，检查输入email地址的格式
         EmailAutoCompleteTextView ev = (EmailAutoCompleteTextView) v;
         String text = ev.getText().toString();
         //这里正则写的有点粗暴:)
         if(text != null && text.matches("^[a-zA-Z0-9_]+@[a-zA-Z0-9]+\\.[a-zA-Z0-9]+$")) {
           Toast to = new Toast(context);
           ImageView i = new ImageView(context);
           i.setBackgroundResource(R.drawable.img_success);
           to.setView(i);
           to.show();
         } else {
           Toast toast = Toast.makeText(context, "邮件地址格式不正确", Toast.LENGTH_SHORT);
           toast.setGravity(Gravity.TOP, 0, 50);
           toast.show();
         }
       }
     }
   });
 }

@Override
 protected void replaceText(CharSequence text) {
   //当我们在下拉框中选择一项时，android会默认使用AutoCompleteTextView中Adapter里的文本来填充文本域
   //因为这里Adapter中只是存了常用email的后缀
   //因此要重新replace逻辑，将用户输入的部分与后缀合并
   Log.i(TAG + " replaceText", text.toString());
   String t = this.getText().toString();
   int index = t.indexOf("@");
   if(index != -1)
     t = t.substring(0, index);
   super.replaceText(t + text);
 }

@Override
 protected void performFiltering(CharSequence text, int keyCode) {
   //该方法会在用户输入文本之后调用，将已输入的文本与adapter中的数据对比，若它匹配
   //adapter中数据的前半部分，那么adapter中的这条数据将会在下拉框中出现
   Log.i(TAG + " performFiltering", text.toString() + "  " + keyCode);
   String t = text.toString();

//因为用户输入邮箱时，都是以字母，数字开始，而我们的adapter中只会提供以类似于"@163.com"
   //的邮箱后缀，因此在调用super.performFiltering时，传入的一定是以"@"开头的字符串
   int index = t.indexOf("@");
   if(index == -1) {
     if(t.matches("^[a-zA-Z0-9_]+$")) {
       super.performFiltering("@", keyCode);
     }
     else
       this.dismissDropDown();//当用户中途输入非法字符时，关闭下拉提示框
   } else {
     super.performFiltering(t.substring(index), keyCode);
   }
 }

private class EmailAutoCompleteAdapter extends ArrayAdapter<String> {

public EmailAutoCompleteAdapter(Context context, int textViewResourceId, String[] email_s) {
     super(context, textViewResourceId, email_s);
   }

@Override
   public View getView(int position, View convertView, ViewGroup parent) {
     Log.i(TAG, "in GetView");
     View v = convertView;
     if (v == null)
       v = LayoutInflater.from(getContext()).inflate(
           R.layout.auto_complete_item, null);
     TextView tv = (TextView) v.findViewById(R.id.tv);

String t = EmailAutoCompleteTextView.this.getText().toString();
     int index = t.indexOf("@");
     if(index != -1)
       t = t.substring(0, index);
     //将用户输入的文本与adapter中的email后缀拼接后，在下拉框中显示
     tv.setText(t + getItem(position));
     Log.i(TAG, tv.getText().toString());
     return v;
   }
 }
}

activity的xml文件如下：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
 android:layout_width="match_parent"
 android:layout_height="match_parent"
 android:orientation="vertical" >

<com.example.testautocompletetextview.EmailAutoCompleteTextView
   android:id="@+id/act"
   android:layout_width="match_parent"
   android:layout_height="wrap_content"
   android:hint="Email Address"
   android:textColor="@color/black" />

<!-- 用于测试移开焦点 -->
 <EditText
   android:layout_width="match_parent"
   android:layout_height="wrap_content"
   android:layout_marginTop="20dp"
   android:drawableLeft="@drawable/amount_selected" />

</LinearLayout>
下拉提示框中每一项（TextView）的xml：

<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
 android:id="@+id/tv"
 android:padding="8dp"
 android:layout_width="match_parent"
 android:layout_height="wrap_content" />

提示截图：