AutoCompleteTextView 简单用法

网上有不少教程，那个提示框字符集都是事先写好的，例如用一个String[] 数组去包含了这些数据，但是，我们也可以吧用户输入的作为历史记录保存
       下面先上我写的代码：
import android.app.Activity;

[java] view plaincopy

1. import android.content.SharedPreferences;  
2. import android.os.Bundle;  
3. import android.util.Log;  
4. import android.view.View;  
5. import android.view.View.OnClickListener;  
6. import android.view.View.OnFocusChangeListener;  
7. import android.widget.ArrayAdapter;  
8. import android.widget.AutoCompleteTextView;  
9. import android.widget.Button;  
10.   
11. public class Read_historyActivity extends Activity implements  
12.         OnClickListener {  
13.     private AutoCompleteTextView autoTv;  
14.   
15.     /** Called when the activity is first created. */  
16.     @Override  
17.     public void onCreate(Bundle savedInstanceState) {  
18.         super.onCreate(savedInstanceState);  
19.         setContentView(R.layout.main);  
20.         autoTv = (AutoCompleteTextView) findViewById(R.id.autoCompleteTextView1);  
21.         initAutoComplete("history",autoTv);  
22.         Button search = (Button) findViewById(R.id.button1);  
23.         search.setOnClickListener(this);  
24.     }  
25.     @Override  
26.     public void onClick(View v) {  
27.         // 这里可以设定：当搜索成功时，才执行保存操作  
28.         saveHistory("history",autoTv);  
29.     }  
30.   
31.     /** 
32.      * 初始化AutoCompleteTextView，最多显示5项提示，使 
33.      * AutoCompleteTextView在一开始获得焦点时自动提示 
34.      * @param field 保存在sharedPreference中的字段名 
35.      * @param auto 要操作的AutoCompleteTextView 
36.      */  
37.     private void initAutoComplete(String field,AutoCompleteTextView auto) {  
38.         SharedPreferences sp = getSharedPreferences("network_url", 0);  
39.         String longhistory = sp.getString("history", "nothing");  
40.         String[]  hisArrays = longhistory.split(",");  
41.         ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,  
42.                 android.R.layout.simple_dropdown_item_1line, hisArrays);  
43.         //只保留最近的50条的记录  
44.         if(hisArrays.length > 50){  
45.             String[] newArrays = new String[50];  
46.             System.arraycopy(hisArrays, 0, newArrays, 0, 50);  
47.             adapter = new ArrayAdapter<String>(this,  
48.                     android.R.layout.simple_dropdown_item_1line, newArrays);  
49.         }  
50.         auto.setAdapter(adapter);  
51.         auto.setDropDownHeight(350);  
52.         auto.setThreshold(1);  
53.         auto.setCompletionHint("最近的5条记录");  
54.         auto.setOnFocusChangeListener(new OnFocusChangeListener() {  
55.             @Override  
56.             public void onFocusChange(View v, boolean hasFocus) {  
57.                 AutoCompleteTextView view = (AutoCompleteTextView) v;  
58.                 if (hasFocus) {  
59.                         view.showDropDown();  
60.                 }  
61.             }  
62.         });  
63.     }  
64.   
65.   
66.   
67.     /** 
68.      * 把指定AutoCompleteTextView中内容保存到sharedPreference中指定的字符段 
69.      * @param field  保存在sharedPreference中的字段名 
70.      * @param auto  要操作的AutoCompleteTextView 
71.      */  
72.     private void saveHistory(String field,AutoCompleteTextView auto) {  
73.         String text = auto.getText().toString();  
74.         SharedPreferences sp = getSharedPreferences("network_url", 0);  
75.         String longhistory = sp.getString(field, "nothing");  
76.         if (!longhistory.contains(text + ",")) {  
77.             StringBuilder sb = new StringBuilder(longhistory);  
78.             sb.insert(0, text + ",");  
79.             sp.edit().putString("history", sb.toString()).commit();  
80.         }  
81. <span style="font-family: monospace; white-space: pre; background-color: rgb(240, 240, 240); "> }  
82. }</span>  

              上面的代码我实现了autocomplettextview的从sharepreference中读取历史记录并显示的功能，当没有任何输入时，提示最新的5项历史记录（这里可以加个条件，当有历史记录时才显示）
              补上布局的代码

[html] view plaincopy

1. <?xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout  
3.     xmlns:android="http://schemas.android.com/apk/res/android"  
4.     android:orientation="vertical"  
5.     android:layout_width="fill_parent"  
6.     android:layout_height="fill_parent">  
7.     <TextView android:layout_width="fill_parent"  
8.         android:layout_height="wrap_content"  
9.         android:text="@string/hello" />  
10.     <LinearLayout android:layout_width="0px"  
11.         android:layout_height="0px" android:focusable="true"  
12.         android:focusableInTouchMode="true"></LinearLayout>  
13.     <AutoCompleteTextView  
14.         android:hint="请输入文字进行搜索" android:layout_height="wrap_content"  
15.         android:layout_width="match_parent"  
16.         android:id="@+id/autoCompleteTextView1">  
17.     </AutoCompleteTextView>  
18.     <Button android:text="搜索" android:id="@+id/button1"  
19.         android:layout_width="wrap_content"  
20.         android:layout_height="wrap_content"></Button>  
21. </LinearLayout>  

          当之有一个edittext或者auto的时候，进入画面时是默认得到焦点的，要想去除焦点，可以在auto之前加一个o像素的layout，并设置他先得到焦点。

效果图如下

下面出现的是源码内容 
               需要注意的是，我这里用到的AutoCompleteTextView的几个方法
               1. setAdapter（）方法：这里要传递的adapter参数必须是继承ListAdapter和Filterable的，其中arrayAdapter和simpleAdapter都能满足要求，我们常用arrayAdapter，因为他不需要像simpleAdapte那样设置他的显示位置和textview组件。
               要想掌握它，就必须查看他的源码，我们可以看看arrayadapter是如何实现
              凡是继承了Filterable的adapter都必须重写getFilter接口方法

[java] view plaincopy

1. public Filter getFilter() {  
2.     if (mFilter == null) {  
3.         mFilter = new ArrayFilter();  
4.     }  
5.     return mFilter;  
6. }  

          这个filter 就是实现过滤方法的对象，同样，我们可以查看他的源码是如何实现的
           

[java] view plaincopy

1. /** 
2.     * <p>An array filter constrains the content of the array adapter with 
3.     * a prefix. Each item that does not start with the supplied prefix 
4.     * is removed from the list.</p> 
5.     */  
6.    private class ArrayFilter extends Filter {  
7.        @Override  
8.        protected FilterResults performFiltering(CharSequence prefix) {  
9.            FilterResults results = new FilterResults();  
10.   
11.            if (mOriginalValues == null) {  
12.                synchronized (mLock) {  
13.                    mOriginalValues = new ArrayList<T>(mObjects);  
14.                }  
15.            }  
16.   
17.            if (prefix == null || prefix.length() == 0) {  
18.                synchronized (mLock) {  
19.                    ArrayList<T> list = new ArrayList<T>(mOriginalValues);  
20.                    results.values = list;  
21.                    results.count = list.size();  
22.                }  
23.            } else {  
24.                String prefixString = prefix.toString().toLowerCase();  
25.   
26.                final ArrayList<T> values = mOriginalValues;  
27.                final int count = values.size();  
28.   
29.                final ArrayList<T> newValues = new ArrayList<T>(count);  
30.   
31.                for (int i = 0; i < count; i++) {  
32.                    final T value = values.get(i);  
33.                    final String valueText = value.toString().toLowerCase();  
34.   
35.                    // First match against the whole, non-splitted value  
36.                    if (valueText.startsWith(prefixString)) {  
37.                        newValues.add(value);  
38.                    } else {  
39.                        final String[] words = valueText.split(" ");  
40.                        final int wordCount = words.length;  
41.   
42.                        for (int k = 0; k < wordCount; k++) {  
43.                            if (words[k].startsWith(prefixString)) {  
44.                                newValues.add(value);  
45.                                break;  
46.                            }  
47.                        }  
48.                    }  
49.                }  
50.   
51.                results.values = newValues;  
52.                results.count = newValues.size();  
53.            }  
54.   
55.            return results;  
56.        }  

          这是arrayAdapter自定义的一个私有内部类，所谓私有，就意味着你不能通过继承去修改这种过滤方法，同样你也不能直接得到他过滤后结果集results。假如你想使用新的过滤方法，你必须重写getfilter()方法，返回的filter对象是你要新建的filter对象（在里面包含performFiltering()方法重新构造你要的过滤方法）
          
         2.setDropDownHeight方法 ，用来设置提示下拉框的高度，注意，这只是限制了提示下拉框的高度，提示数据集的个数并没有变化
         3.setThreshold方法，设置从输入第几个字符起出现提示
         4.setCompletionHint方法，设置提示框最下面显示的文字
         5.setOnFocusChangeListener方法，里面包含OnFocusChangeListener监听器，设置焦点改变事件
         6.showdropdown方法，让下拉框弹出来
         

        我没有用到的一些方法列举
1.clearListSelection，去除selector样式，只是暂时的去除，当用户再输入时又重新出现
2.dismissDropDown，关闭下拉提示框
3.enoughToFilter，这是一个是否满足过滤条件的方法，sdk建议我们可以重写这个方法
4. getAdapter，得到一个可过滤的列表适配器
5.getDropDownAnchor，得到下拉框的锚计的view的id
6.getDropDownBackground，得到下拉框的背景色
7.setDropDownBackgroundDrawable，设置下拉框的背景色
8.setDropDownBackgroundResource，设置下拉框的背景资源
9.setDropDownVerticalOffset，设置下拉表垂直偏移量，即是list里包含的数据项数目
10.getDropDownVerticalOffset ，得到下拉表垂直偏移量
11..setDropDownHorizontalOffset，设置水平偏移量
12.setDropDownAnimationStyle，设置下拉框的弹出动画
13.getThreshold，得到过滤字符个数
14.setOnItemClickListener，设置下拉框点击事件
15.getListSelection，得到下拉框选中为位置
16.getOnItemClickListener。得到单项点击事件
17.getOnItemSelectedListener得到单项选中事件
18.getAdapter，得到那个设置的适配器

一些隐藏方法和构造我没有列举了，具体可以参考api文档 
可下载我的写的demo： http://download.csdn.net/detail/iamkila/4042528

自定义：

网上找到的都是同ArrayAdapter一起使用的，有时候需要自定义风格，咋办？follow me！ 

 
看上图，实现了清空输入框内容和删除Item功能。 

其实使用AutoCompleteTextView就得实现过滤器Filterable，你得告诉它怎么过滤。由于ArrayAdapter已经帮我们实现了Filterable接口，所以我们很容易忽略这个，以为AutoCompleteTextView用起来很简单。如果你使用的是BaseAdapter呢？当然，事实上也不难，只要让它也实现Filterable接口就可以了。 

下面是源码： 
实现自定义的Adapter 

Java代码  

1. import java.util.ArrayList;  
2. import java.util.List;  
3.   
4. import qianlong.qlmobile.tablet.csco.R;  
5.   
6. import android.content.Context;  
7. import android.util.Log;  
8. import android.view.LayoutInflater;  
9. import android.view.View;  
10. import android.view.ViewGroup;  
11. import android.view.View.OnClickListener;  
12. import android.widget.BaseAdapter;  
13. import android.widget.Filter;  
14. import android.widget.Filterable;  
15. import android.widget.ImageView;  
16. import android.widget.TextView;  
17.   
18. public class AutoCompleteAdapter extends BaseAdapter implements Filterable{  
19.     private Context context;  
20.     private ArrayFilter mFilter;  
21.     private ArrayList<String> mOriginalValues;//所有的Item  
22.     private List<String> mObjects;//过滤后的item  
23.     private final Object mLock = new Object();  
24.     private int maxMatch=10;//最多显示多少个选项,负数表示全部  
25.     public AutoCompleteAdapter(Context context,ArrayList<String> mOriginalValues,int maxMatch){  
26.         this.context=context;  
27.         this.mOriginalValues=mOriginalValues;  
28.         this.maxMatch=maxMatch;  
29.     }  
30.       
31.     @Override  
32.     public Filter getFilter() {  
33.         // TODO Auto-generated method stub  
34.         if (mFilter == null) {    
35.             mFilter = new ArrayFilter();    
36.         }    
37.         return mFilter;  
38.     }  
39.       
40.     private class ArrayFilter extends Filter {  
41.   
42.         @Override  
43.         protected FilterResults performFiltering(CharSequence prefix) {  
44.             // TODO Auto-generated method stub  
45.             FilterResults results = new FilterResults();    
46.                 
47. //          if (mOriginalValues == null) {    
48. //                synchronized (mLock) {    
49. //                    mOriginalValues = new ArrayList<String>(mObjects);//    
50. //                }    
51. //            }  
52.               
53.             if (prefix == null || prefix.length() == 0) {    
54.                 synchronized (mLock) {  
55.                     Log.i("tag", "mOriginalValues.size="+mOriginalValues.size());  
56.                     ArrayList<String> list = new ArrayList<String>(mOriginalValues);    
57.                     results.values = list;    
58.                     results.count = list.size();   
59.                     return results;  
60.                 }    
61.             } else {  
62.                 String prefixString = prefix.toString().toLowerCase();    
63.     
64.                 final int count = mOriginalValues.size();    
65.     
66.                 final ArrayList<String> newValues = new ArrayList<String>(count);    
67.     
68.                 for (int i = 0; i < count; i++) {  
69.                     final String value = mOriginalValues.get(i);    
70.                     final String valueText = value.toLowerCase();    
71.     
72. //                    if(valueText.contains(prefixString)){//匹配所有  
73. //                        
74. //                    }  
75.                     // First match against the whole, non-splitted value    
76.                     if (valueText.startsWith(prefixString)) {  //源码 ,匹配开头  
77.                         newValues.add(value);    
78.                     }   
79. //                    else {    
80. //                        final String[] words = valueText.split(" ");//分隔符匹配，效率低  
81. //                        final int wordCount = words.length;    
82. //    
83. //                        for (int k = 0; k < wordCount; k++) {    
84. //                            if (words[k].startsWith(prefixString)) {    
85. //                                newValues.add(value);    
86. //                                break;    
87. //                            }    
88. //                        }    
89. //                    }  
90.                     if(maxMatch>0){//有数量限制    
91.                         if(newValues.size()>maxMatch-1){//不要太多    
92.                             break;    
93.                         }    
94.                     }    
95.                 }    
96.     
97.                 results.values = newValues;    
98.                 results.count = newValues.size();    
99.             }    
100.     
101.             return results;  
102.         }  
103.   
104.         @Override  
105.         protected void publishResults(CharSequence constraint,  
106.                 FilterResults results) {  
107.             // TODO Auto-generated method stub  
108.             mObjects = (List<String>) results.values;    
109.             if (results.count > 0) {    
110.                 notifyDataSetChanged();    
111.             } else {    
112.                 notifyDataSetInvalidated();    
113.             }  
114.         }  
115.           
116.     }  
117.   
118.     @Override  
119.     public int getCount() {  
120.         // TODO Auto-generated method stub  
121.         return mObjects.size();  
122.     }  
123.   
124.     @Override  
125.     public Object getItem(int position) {  
126.         // TODO Auto-generated method stub  
127.         //此方法有误，尽量不要使用  
128.         return mObjects.get(position);  
129.     }  
130.   
131.     @Override  
132.     public long getItemId(int position) {  
133.         // TODO Auto-generated method stub  
134.         return position;  
135.     }  
136.   
137.     @Override  
138.     public View getView(final int position, View convertView, ViewGroup parent) {  
139.         // TODO Auto-generated method stub  
140.         ViewHolder holder = null;  
141.         if(convertView==null){  
142.             holder=new ViewHolder();  
143.             LayoutInflater inflater = (LayoutInflater)context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);  
144.             convertView=inflater.inflate(R.layout.simple_list_item_for_autocomplete, null);  
145.             holder.tv=(TextView)convertView.findViewById(R.id.simple_item_0);    
146.             holder.iv=(ImageView)convertView.findViewById(R.id.simple_item_1);  
147.             convertView.setTag(holder);  
148.         }else{  
149.             holder = (ViewHolder) convertView.getTag();  
150.         }  
151.           
152.         holder.tv.setText(mObjects.get(position));  
153.         holder.iv.setOnClickListener(new OnClickListener() {  
154.               
155.             @Override  
156.             public void onClick(View v) {  
157.                 // TODO Auto-generated method stub  
158.                 String obj=mObjects.remove(position);  
159.                 mOriginalValues.remove(obj);  
160.                 notifyDataSetChanged();  
161.             }  
162.         });  
163.         return convertView;  
164.     }  
165.   
166.     class ViewHolder {  
167.         TextView tv;  
168.         ImageView iv;  
169.     }  
170.       
171.     public ArrayList<String> getAllItems(){  
172.         return mOriginalValues;  
173.     }  
174. }  

Java代码  

1. import android.content.Context;  
2. import android.util.AttributeSet;  
3. import android.view.View;  
4. import android.widget.AutoCompleteTextView;  
5. import android.widget.ImageView;  
6. import android.widget.RelativeLayout;  
7. import android.widget.ImageView.ScaleType;  
8.   
9. public class AdvancedAutoCompleteTextView extends RelativeLayout{  
10.   
11.     private Context context;  
12.     private AutoCompleteTextView tv;  
13.     public AdvancedAutoCompleteTextView(Context context) {  
14.         super(context);  
15.         // TODO Auto-generated constructor stub  
16.         this.context=context;  
17.     }  
18.     public AdvancedAutoCompleteTextView(Context context, AttributeSet attrs) {  
19.         super(context, attrs);  
20.         // TODO Auto-generated constructor stub  
21.         this.context=context;  
22.     }  
23.   
24.     @Override  
25.     protected void onFinishInflate() {  
26.         super.onFinishInflate();  
27.         initViews();  
28.     }  
29.   
30.     private void initViews() {  
31.         RelativeLayout.LayoutParams params=new RelativeLayout.LayoutParams(RelativeLayout.LayoutParams.FILL_PARENT,RelativeLayout.LayoutParams.WRAP_CONTENT);  
32.         tv=new AutoCompleteTextView(context);  
33.         tv.setLayoutParams(params);  
34.         tv.setPadding(10, 0, 40, 0);  
35. //      tv.setSingleLine(true);  
36.           
37.         RelativeLayout.LayoutParams p=new RelativeLayout.LayoutParams(RelativeLayout.LayoutParams.WRAP_CONTENT,RelativeLayout.LayoutParams.WRAP_CONTENT);  
38.         p.addRule(RelativeLayout.ALIGN_PARENT_RIGHT);  
39.         p.addRule(RelativeLayout.CENTER_VERTICAL);  
40.         p.rightMargin=10;  
41.         ImageView iv=new ImageView(context);  
42.         iv.setLayoutParams(p);  
43.         iv.setScaleType(ScaleType.FIT_CENTER);  
44.         iv.setImageResource(R.drawable.delete);  
45.         iv.setClickable(true);  
46.         iv.setOnClickListener(new View.OnClickListener() {  
47.               
48.             @Override  
49.             public void onClick(View v) {  
50.                 // TODO Auto-generated method stub  
51.                 tv.setText("");  
52.             }  
53.         });  
54.               
55.         this.addView(tv);  
56.         this.addView(iv);  
57.           
58.           
59.     }  
60.       
61.     public void setAdapter(AutoCompleteAdapter adapter){  
62.         tv.setAdapter(adapter);  
63.     }  
64.       
65.     public void setThreshold(int threshold){  
66.         tv.setThreshold(threshold);  
67.     }  
68.       
69.     public AutoCompleteTextView getAutoCompleteTextView(){  
70.         return tv;  
71.     }  
72. }  

simple_list_item_for_autocomplete.xml 

Xml代码  

1. <?xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     android:layout_width="fill_parent"  
4.     android:layout_height="wrap_content"  
5.     android:orientation="horizontal"  
6.     android:paddingTop="5dip"  
7.     android:paddingBottom="5dip"  
8.     >  
9.     <TextView android:id="@+id/simple_item_0"  
10.         android:layout_width="fill_parent"  
11.         android:layout_height="wrap_content"  
12.         android:layout_weight="1"  
13.         android:paddingLeft="5dip"  
14.         android:textColor="@android:color/black"  
15.         />  
16.     <ImageView android:id="@+id/simple_item_1"  
17.         android:layout_width="wrap_content"  
18.         android:layout_height="wrap_content"  
19.         android:scaleType="fitCenter"  
20.         android:src="@drawable/delete"  
21.         android:layout_centerVertical="true"  
22.         android:layout_marginRight="5dip"  
23.         />  
24. </LinearLayout>  

使用，通常情况下都这样： 

Java代码  

1. private AdvancedAutoCompleteTextView tv;  
2.     private AutoCompleteAdapter adapter;  
3.     private ArrayList<String> mOriginalValues=new ArrayList<String>();  
4.     @Override  
5.     public void onCreate(Bundle savedInstanceState) {  
6.         super.onCreate(savedInstanceState);  
7.         setContentView(R.layout.main);  
8.           
9.         mOriginalValues.add("1234561");  
10.         mOriginalValues.add("1234562");  
11.         mOriginalValues.add("2234563");  
12.         mOriginalValues.add("2234564");  
13.         mOriginalValues.add("3234561111");  
14.         mOriginalValues.add("32345622222");  
15.         mOriginalValues.add("323456333333");  
16.         mOriginalValues.add("3234564444");  
17.         mOriginalValues.add("3234565555");  
18.         mOriginalValues.add("32345666666");  
19.         mOriginalValues.add("32345777777");  
20.           
21.         tv = (AdvancedAutoCompleteTextView) findViewById(R.id.tv);  
22.         tv.setThreshold(0);  
23.         adapter = new AutoCompleteAdapter(this, mOriginalValues, 10);  
24.         tv.setAdapter(adapter);  
25.     } 
26. 
    
27. http://gundumw100.iteye.com/blog/1446507