AutoCompleteTextView自动完成文本框基本使用教程

时间：2026-08-13 19:12

本节引言：这一节继续讲 Adapter 相关控件，这次的主角是 AutoCompleteTextView，也就是自动完成文本框。说到这里，细心的同学应该已经能发现一个规律：凡是和 Adapter 绑定的控件，item 样式通常都可以自定义。也就是说，每个条目使用什么布局、展示成什么效果，灵活度都很

本节引言：

这一节继续讲 Adapter 相关控件，这次的主角是 AutoCompleteTextView，也就是自动完成文本框。说到这里，细心的同学应该已经能发现一个规律：凡是和 Adapter 绑定的控件，item 样式通常都可以自定义。也就是说，每个条目使用什么布局、展示成什么效果，灵活度都很高。好了，先不绕弯子，直接进入本节内容。顺手把官方 API 也放在这里：AutoCompleteTextView

1.相关属性：

android:completionHint：设置下拉提示框中的提示标题

android:completionHintView：定义提示视图中显示的下拉菜单

android:completionThreshold：指定用户至少输入多少个字符后才显示提示

android:dropDownAnchor：设置下拉菜单的定位“锚点”组件，如果没有指定该属性，将默认使用该 TextView 作为定位“锚点”组件

android:dropDownHeight：设置下拉菜单的高度

android:dropDownWidth：设置下拉菜单的宽度

android:dropDownHorizontalOffset：指定下拉菜单与文本之间的水平间距

android:dropDownVerticalOffset：指定下拉菜单与文本之间的竖直间距

android:dropDownSelector：设置下拉菜单点击效果

android:popupBackground：设置下拉菜单的背景

另外，还有一个MultiAutoCompleteTextView（多提示项自动完成文本框），它和 AutoCompleteTextView 的用途基本接近，相关属性也差不多。那它们到底有什么区别？别着急，下面结合代码来实际感受一下。顺带一提，这两个控件默认都是按整词匹配的。比如有一项是“小猪猪”，输入“小”时会出现“小猪猪”的提示，但如果输入“猪猪”，它反而不会把“小猪猪”匹配出来。

2.代码示例：

运行效果图：

实现代码：

这里就不自定义布局了，直接使用 ArrayAdapter 来实现。

布局文件：activity_main.xml：

MainActivity.ja va：

public class MainActivity extends AppCompatActivity {
private AutoCompleteTextView atv_content;
    private MultiAutoCompleteTextView matv_content;
private static final String[] data = new String[]{
            "小猪猪", "小狗狗", "小鸡鸡", "小猫猫", "小咪咪"
    };
@Override
    protected void onCreate(Bundle sa vedInstanceState) {
        super.onCreate(sa vedInstanceState);
        setContentView(R.layout.activity_main);
        atv_content = (AutoCompleteTextView) findViewById(R.id.atv_content);
        matv_content = (MultiAutoCompleteTextView) findViewById(R.id.matv_content);
ArrayAdapter adapter = new ArrayAdapter(MainActivity.
                this, android.R.layout.simple_dropdown_item_1line, data);
        atv_content.setAdapter(adapter);
ArrayAdapter adapter2 = new ArrayAdapter(getApplicationContext(), android.R.layout.simple_dropdown_item_1line, data);
        matv_content.setAdapter(adapter);
        matv_content.setTokenizer(new MultiAutoCompleteTextView.CommaTokenizer());
    }
}

部分代码分析：

android:completionThreshold="1"：这里设置为输入一个字就显示提示

android:completionHint="请输入搜索内容"：这是框框底部显示的文字，如果觉得不美观，可以通过 android:completionHintView 设置一个 View

android:dropDownHorizontalOffset="5dp"：设置水平边距为 5dp

matv_content.setTokenizer(new MultiAutoCompleteTextView.CommaTokenizer()); setTokenizer 是为其设置分隔符