Android AutoCompleteTextView：自动完成文本框控件

àì夳堔傛蜴生んèń 2021-12-09 23:11 390阅读 0赞

在使用百度或者 Google 搜索信息时，只需要在搜索框中输入几个关键字，就会有很多相关的信息以列表形式被列举出来供用户选择，这种效果在 [Android][] SDK 中可以通过 AutoCompleteTextView 来实现。  
  
下面用一个简单的实例讲解 AutoCompleteTextView 的使用方法。在工程 WidgetDemo 的布局文件 main.xml 中添加一个 Button，用以启动 AutoCompleteTextViewActivity。  
  
在 main.xml 中添加代码如下：

1.  <Button
2.  android:id="@+id/button5"
3.  android:layout\_width="wrap\_content"
4.  android:layout\_height="wrap\_content"
5.  android:text="AutoCompleteTextViewDemo"/>

单击 Button 并启动 AutoCompleteTextViewActivity 的代码如下：

1.  Button autobtn = (Button)this.findViewById(R.id.button5);
2.  autobtn.setOnClickListener(new OnClickListener()\{
3.  @Override
4.  public void onClick(View v)\{
5.  Intent intent = new Intent(WidgetDemoActivity.this, AutoCompleteTextViewActivity.class);
6.  startActivity(intent);
7.  \}
8.  \});

同时在 AndroidManifest.xml 文件中声明该 Activity：

AutoCompleteTextViewActivity 的运行效果如图 1 所示。

![AutoCompleteTextViewActivity的运行效果][AutoCompleteTextViewActivity]  
图 1 AutoCompleteTextViewActivity 的运行效果

AutoCompleteTextViewActivity 使用的布局文件为 autocompletetextview.xml，其具体内容如下：

1.  <?xml version="1.0" encoding="utf-8"?>
2.  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
3.  android:layout\_width="match\_parent"
4.  android:layout\_height="match\_parent"
5.  android:orientation="vertical">
6.  
7.  <TextView
8.  android:layout\_width="fill\_parent"
9.  android:layout\_height="wrap\_content"
10. android:text="AutoCompleteTextView演示：" />
11. 
12. <AutoCompleteTextView
13. android:id="@+id/autoCompleteTextView1"
14. android:layout\_width="match\_parent"
15. android:layout\_height="wrap\_content"
16. android:text="" />
17. 
18. <requestFocus />
19. </LinearLayout>

AutoCompleteTextViewActivity.java 的代码如下：

1.  package introduction.android.widgetdemo;
2.  
3.  import android.app.Activity;
4.  import android.support.v7.app.AppCompatActivity;
5.  import android.os.Bundle;
6.  import android.widget.ArrayAdapter;
7.  import android.widget.AutoCompleteTextView;
8.  import android.widget.Button;
9.  
10. public class MainActivity extends Activity \{
11. private AutoCompleteTextView textView;
12. private static final String\[\] autotext = new String\[\]\{"张三","张无忌","张三丰"\};
13. 
14. @Override
15. public void onCreat(Bundle savedInstanceState)\{
16. super.onCreate(savedInstanceState);
17. setContentView(R.layout.autocompletetextview);
18. textView = (AutoCompleteTextView)findViewById(R.id.autoCompleteTextView1);
19. /\*new ArrayAdapterd 对象将 autotext字符串数组传入\*/
20. ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,android.R.layout.simple\_dropdown\_item\_1line,autotext);
21. /\*将ArrayAdapter添加到AutoCompleteTextView中\*/
22. textView.setAdapter(adapter);
23. \}
24. \}

AutoCompleteTextViewActivity 中为可自动补全的内容建立对应字符串数组 autotext，将该数组关联到 ArrayAdapter 中，然后将 ArrayAdapter 与 AutoCompleteTextView 相关联，进而实现自动完成文本功能。  
  
AutoCompleteTextView 提供一系列属性对显示效果进行设置，分别说明如下。

*  completionThreshold：它的值决定了你在 AutoCompleteTextView 中至少输入几个字符，才会具有自动提示的功能。另外，默认最多提示 20 条。
 *  dropDownAnchor：它的值是一个 View 的 ID，指定后，AutoCompleteTextView 会在这个 View 下弹出自动提示。
 *  dropDownSelector：应该是设置自动提示的背景色之类的，没有尝试过，有待进一步考证。
 *  dropDownWidth：设置自动提示列表的宽度。

[Android]: http://c.biancheng.net/android/
[AutoCompleteTextViewActivity]: /images/20211209/28b0111f68e9413dac402820f2646a6c.png