Android自動補全教程

創建一個能自動補全提示的文本輸入控件（widget），可以使用AutoCompleteTextView控件。提示從與控件關聯的ArrayAdapter提供的字符串集合得到。

在這個教程中，你將要創建一個自動提示國家名字的AutoCompleteTextView。

啟動一個新項目並命名為HelloAutoComplete。

創建一個名為list_item.xml的XML文件並把它保存在res/layout/文件夾下。編輯文件像下面這樣：

[html]

1. <?xml version="1.0" encoding="utf-8"?>  
2. <TextView xmlns:Android="http://schemas.android.com/apk/res/android"  
3.     android:layout_width="fill_parent"  
4.     android:layout_height="fill_parent"  
5.     android:padding="10dp"  
6.     android:textSize="16sp"  
7.     android:textColor="#000">  
8. </TextView>  

這個文件定義了一個簡單的TextView來顯示提示列表的每一項。

打開 res/layout/main.xml文件加入如下內容：

[html]

1. <?xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"   
3.     android:orientation="horizontal"  
4.     android:layout_width="fill_parent"   
5.     android:layout_height="wrap_content"  
6.     android:padding="5dp">  
7.     <TextView  
8.         android:layout_width="wrap_content"  
9.         android:layout_height="wrap_content"  
10.         android:text="Country" />  
11.     <AutoCompleteTextView android:id="@+id/autocomplete_country"  
12.         android:layout_width="fill_parent"  
13.         android:layout_height="wrap_content"  
14.         android:layout_marginLeft="5dp"/>  
15. </LinearLayout>  

這個TextView是一個介紹AutoCompleteTextView控件的標簽。

打開HelloAutoComplete.java並在onCreate()函數中添加如下代碼： 

[java]

1. @Override  
2. protected void onCreate(Bundle savedInstanceState) {  
3.     super.onCreate(savedInstanceState);  
4.     setContentView(R.layout.main);  
5.   
6.     AutoCompleteTextView textView = (AutoCompleteTextView) findViewById(R.id.autocomplete_country);  
7.     ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, R.layout.list_item, COUNTRIES);  
8.     textView.setAdapter(adapter);  
9. }  

把main.xml布局設置為內容視圖後，AutoCompleteTextView控件就會在布局中用findViewById(int)找到。接下來，一個新的ArrayAdapter初始化並把

COUNTRIES字符串數組（在下一步定義）的每個列表項綁定到 list_item.xml布局。最後，調用setAdapter()將AutoCompleteTextView和ArrayAdapter關聯起來，這樣字符串數組就能填充到提示列表中。

在HelloAutoComplete類中加入字符串數組：

[java]

1. static final String[] COUNTRIES = new String[] {  
2.   "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra",  
3.   "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina",  
4.   "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan",  
5.   "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium",  
6.   "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia",  
7.   "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory",  
8.   "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi",  
9.   "Cote d'Ivoire", "Cambodia", "Cameroon", "Canada", "Cape Verde",  
10.   "Cayman Islands", "Central African Republic", "Chad", "Chile", "China",  
11.   "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo",  
12.   "Cook Islands", "Costa Rica", "Croatia", "Cuba", "Cyprus", "Czech Republic",  
13.   "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic",  
14.   "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea",  
15.   "Estonia", "Ethiopia", "Faeroe Islands", "Falkland Islands", "Fiji", "Finland",  
16.   "Former Yugoslav Republic of Macedonia", "France", "French Guiana", "French Polynesia",  
17.   "French Southern Territories", "Gabon", "Georgia", "Germany", "Ghana", "Gibraltar",  
18.   "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guinea", "Guinea-Bissau",  
19.   "Guyana", "Haiti", "Heard Island and McDonald Islands", "Honduras", "Hong Kong", "Hungary",  
20.   "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Jamaica",  
21.   "Japan", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos",  
22.   "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg",  
23.   "Macau", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands",  
24.   "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova",  
25.   "Monaco", "Mongolia", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia",  
26.   "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand",  
27.   "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "Northern Marianas",  
28.   "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru",  
29.   "Philippines", "Pitcairn Islands", "Poland", "Portugal", "Puerto Rico", "Qatar",  
30.   "Reunion", "Romania", "Russia", "Rwanda", "Sqo Tome and Principe", "Saint Helena",  
31.   "Saint Kitts and Nevis", "Saint Lucia", "Saint Pierre and Miquelon",  
32.   "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Saudi Arabia", "Senegal",  
33.   "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands",  
34.   "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Korea",  
35.   "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Swaziland", "Sweden",  
36.   "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "The Bahamas",  
37.   "The Gambia", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey",  
38.   "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Virgin Islands", "Uganda",  
39.   "Ukraine", "United Arab Emirates", "United Kingdom",  
40.   "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan",  
41.   "Vanuatu", "Vatican City", "Venezuela", "Vietnam", "Wallis and Futuna", "Western Sahara",  
42.   "Yemen", "Yugoslavia", "Zambia", "Zimbabwe"  
43. };  

這就是當用戶在AutoCompleteTextView控件輸入時提供給下拉列表的提示。

啟動這個應用程序。

當你輸入時，你將會看到如下：

更多信息
需要注意的是設計實踐中不建議硬編碼（hard-coded）字符串數組，因為你的應用程序將關注於行為，而不是內容。應用程序的內容如字符串會寫在代碼外部這樣做修改時就更方便和容易。這個教程中硬編碼的字符串只是做個例子重點放在了AutoCompleteTextView控件上。相反的，你的應用程序可以聲明這樣的字符串數組在XML文件中。這可以在你的項目中res/values/strings.xml 文件裡用<string-array>資源來完成。請看下面示例：

[html]

1. <?xml version="1.0" encoding="utf-8"?>  
2. <resources>  
3.     <string-array name="countries_array">  
4.         <item>Bahrain</item>  
5.         <item>Bangladesh</item>  
6.         <item>Barbados</item>  
7.         <item>Belarus</item>  
8.         <item>Belgium</item>  
9.         <item>Belize</item>  
10.         <item>Benin</item>  
11.     </string-array>  
12. </resources>  

在ArrayAdapter使用這個資源字符串，只需要替換原來的ArrayAdapter構造部分，像下面一樣：

[java]

1. String[] countries = getResources().getStringArray(R.array.countries_array);  
2. ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, R.layout.list_item, countries);