Known Direct Subclasses
An editable text view that shows completion suggestions automatically while the user is typing. The list of suggestions is displayed in a drop down menu from which the user can choose an item to replace the content of the edit box with.
简单的讲一个类似百度,google等输入搜索字串时自动提示的功能:
常用方法总结
Public Methods |
---|
<nobr><a href="http://developer.android.com/reference/android/widget/ListAdapter.html" style="color:rgb(0,102,153); text-decoration:none">ListAdapter</a></nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#getAdapter()" style="color:rgb(0,102,153); text-decoration:none">getAdapter</a></span>()</nobr>
Returns a filterable list adapter used for auto completion.
| <nobr><a href="http://developer.android.com/reference/android/widget/AdapterView.OnItemClickListener.html" style="color:rgb(0,102,153); text-decoration:none">AdapterView.OnItemClickListener</a></nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#getItemClickListener()" style="color:rgb(0,102,153); text-decoration:none">getItemClickListener</a></span>()</nobr>
| <nobr><a href="http://developer.android.com/reference/android/widget/AdapterView.OnItemSelectedListener.html" style="color:rgb(0,102,153); text-decoration:none">AdapterView.OnItemSelectedListener</a></nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#getItemSelectedListener()" style="color:rgb(0,102,153); text-decoration:none">getItemSelectedListener</a></span>()</nobr>
| <nobr><a href="http://developer.android.com/reference/android/widget/AdapterView.OnItemClickListener.html" style="color:rgb(0,102,153); text-decoration:none">AdapterView.OnItemClickListener</a></nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#getOnItemClickListener()" style="color:rgb(0,102,153); text-decoration:none">getOnItemClickListener</a></span>()</nobr>
Returns the listener that is notified whenever the user clicks an item in the drop down list.
| <nobr><a href="http://developer.android.com/reference/android/widget/AdapterView.OnItemSelectedListener.html" style="color:rgb(0,102,153); text-decoration:none">AdapterView.OnItemSelectedListener</a></nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#getOnItemSelectedListener()" style="color:rgb(0,102,153); text-decoration:none">getOnItemSelectedListener</a></span>()</nobr>
Returns the listener that is notified whenever the user selects an item in the drop down list.
| <nobr>int</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#getThreshold()" style="color:rgb(0,102,153); text-decoration:none">getThreshold</a></span>()</nobr>
Returns the number of characters the user must type before the drop down list is shown.
| <nobr><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.Validator.html" style="color:rgb(0,102,153); text-decoration:none">AutoCompleteTextView.Validator</a></nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#getValidator()" style="color:rgb(0,102,153); text-decoration:none">getValidator</a></span>()</nobr>
| <nobr>boolean</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#isPerformingCompletion()" style="color:rgb(0,102,153); text-decoration:none">isPerformingCompletion</a></span>()</nobr>
Identifies whether the view is currently performing a text completion, so subclasses can decide whether to respond to text changed events.
| <nobr>boolean</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#isPopupShowing()" style="color:rgb(0,102,153); text-decoration:none">isPopupShowing</a></span>()</nobr>
Indicates whether the popup menu is showing.
| <nobr>void</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#onCommitCompletion(android.view.inputmethod.CompletionInfo)" style="color:rgb(0,102,153); text-decoration:none">onCommitCompletion</a></span>(<a href="http://developer.android.com/reference/android/view/inputmethod/CompletionInfo.html" style="color:rgb(0,102,153); text-decoration:none">CompletionInfo</a>completion)</nobr>
| <nobr>void</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#onFilterComplete(int)" style="color:rgb(0,102,153); text-decoration:none">onFilterComplete</a></span>(int count)</nobr>
Notifies the end of a filtering operation.
| <nobr>boolean</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#onKeyDown(int,%20android.view.KeyEvent)" style="color:rgb(0,102,153); text-decoration:none">onKeyDown</a></span>(int keyCode,<a href="http://developer.android.com/reference/android/view/KeyEvent.html" style="color:rgb(0,102,153); text-decoration:none">KeyEvent</a>event)</nobr>
| <nobr>boolean</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#onKeyUp(int,%20android.view.KeyEvent)" style="color:rgb(0,102,153); text-decoration:none">onKeyUp</a></span>(int keyCode,<a href="http://developer.android.com/reference/android/view/KeyEvent.html" style="color:rgb(0,102,153); text-decoration:none">KeyEvent</a>event)</nobr>
| <nobr>void</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#onWindowFocusChanged(boolean)" style="color:rgb(0,102,153); text-decoration:none">onWindowFocusChanged</a></span>(boolean hasWindowFocus)</nobr>
Called when the window containing this view gains or loses focus.
| <nobr><Textends<a href="http://developer.android.com/reference/android/widget/ListAdapter.html" style="color:rgb(0,102,153); text-decoration:none">ListAdapter</a>&<a href="http://developer.android.com/reference/android/widget/Filterable.html" style="color:rgb(0,102,153); text-decoration:none">Filterable</a>> void</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#setAdapter(T)" style="color:rgb(0,102,153); text-decoration:none">setAdapter</a></span>(T adapter)</nobr>
Changes the list of data used for auto completion.
| <nobr>void</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#setCompletionHint(java.lang.CharSequence)" style="color:rgb(0,102,153); text-decoration:none">setCompletionHint</a></span>(<a href="http://developer.android.com/reference/java/lang/CharSequence.html" style="color:rgb(0,102,153); text-decoration:none">CharSequence</a>hint)</nobr>
Sets the optional hint text that is displayed at the bottom of the the matching list.
| <nobr>void</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#setDropDownBackgroundResource(int)" style="color:rgb(0,102,153); text-decoration:none">setDropDownBackgroundResource</a></span>(int id)</nobr>
Sets the background of the auto-complete drop-down list.
| <nobr>void</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#setOnClickListener(android.view.View.OnClickListener)" style="color:rgb(0,102,153); text-decoration:none">setOnClickListener</a></span>(<a href="http://developer.android.com/reference/android/view/View.OnClickListener.html" style="color:rgb(0,102,153); text-decoration:none">View.OnClickListener</a>listener)</nobr>
Register a callback to be invoked when this view is clicked.
| <nobr>void</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#setOnItemClickListener(android.widget.AdapterView.OnItemClickListener)" style="color:rgb(0,102,153); text-decoration:none">setOnItemClickListener</a></span>(<a href="http://developer.android.com/reference/android/widget/AdapterView.OnItemClickListener.html" style="color:rgb(0,102,153); text-decoration:none">AdapterView.OnItemClickListener</a>l)</nobr>
Sets the listener that will be notified when the user clicks an item in the drop down list.
| <nobr>void</nobr> | <nobr><span class="sympad" style="margin-right:2px"><a href="http://developer.android.com/reference/android/widget/AutoCompleteTextView.html#setOnItemSelectedListener(android.widget.AdapterView.OnItemSelectedListener)" style="color:rgb(0,102,153); text-decoration:none">setOnItemSelectedListener</a></span>(<a href="http://developer.android.com/reference/android/widget/AdapterView.OnItemSelectedListener.html" style="color:rgb(0,102,153); text-decoration:none">AdapterView.OnItemSelectedListener</a>l)</nobr>
Sets the listener that will be notified when the user selects an item in the drop down list.
|
下面是一个官方的示例:
To create a text entry widget that provides auto-complete suggestions, use theAutoCompleteTextView widget. Suggestions are received from a collection of strings associated with the widget through anArrayAdapter .
In this tutorial, you will create aAutoCompleteTextView widget that provides suggestions for a country name.
【0】Start a new project namedHelloAutoComplete.
【1】Create an XML file namedlist_item.xml and save it inside theres/layout/ folder. Edit the file to look like this:
<?xml version="1.0" encoding="utf-8"?> <TextView xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" android:padding="10dp" android:textSize="16sp" android:textColor="#000"> </TextView>
This file defines a simpleTextView that will be used for each item that appears in the list of suggestions.
这个文件定义了一个简单的TextView,用来即时显示自动匹配的选项
【2】Open theres/layout/main.xml file and insert the following:
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="horizontal" android:layout_width="fill_parent" android:layout_height="wrap_content" android:padding="5dp"> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Country" /> <AutoCompleteTextView android:id="@+id/autocomplete_country" android:layout_width="fill_parent" android:layout_height="wrap_content" android:layout_marginLeft="5dp"/> </LinearLayout>
TheTextView is a label that introduces theAutoCompleteTextView widget.
【3】OpenHelloAutoComplete.java and insert the following code for theonCreate() method:
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); AutoCompleteTextView textView = (AutoCompleteTextView) findViewById(R.id.autocomplete_country); ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, R.layout.list_item, COUNTRIES); textView.setAdapter(adapter); }
After the content view is set to themain.xml layout, theAutoCompleteTextView widget is captured from the layout withfindViewById(int) . A newArrayAdapter is then initialized to bind thelist_item.xml layout to each list item in theCOUNTRIES string array (defined in the next step). Finally,setAdapter() is called to associate theArrayAdapter with theAutoCompleteTextView widget so that the string array will populate the list of suggestions.
这里new了一个ArrayAdapter用来作为adapter.
【4】Inside theHelloAutoComplete class, add the string array:
static final String[] COUNTRIES = new String[] { "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cote d'Ivoire", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Cook Islands", "Costa Rica", "Croatia", "Cuba", "Cyprus", "Czech Republic", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Faeroe Islands", "Falkland Islands", "Fiji", "Finland", "Former Yugoslav Republic of Macedonia", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macau", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "Northern Marianas", "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn Islands", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romania", "Russia", "Rwanda", "Sqo Tome and Principe", "Saint Helena", "Saint Kitts and Nevis", "Saint Lucia", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Saudi Arabia", "Senegal", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Korea", "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "The Bahamas", "The Gambia", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Virgin Islands", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City", "Venezuela", "Vietnam", "Wallis and Futuna", "Western Sahara", "Yemen", "Yugoslavia", "Zambia", "Zimbabwe" };
This is the list of suggestions that will be provided in a drop-down list when the user types into theAutoCompleteTextView widget.
【5】Run the application.
|