首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >自动完成文本框AutoCompleteTextView实现快速输入

自动完成文本框AutoCompleteTextView实现快速输入

作者头像
分享达人秀
发布2018-02-05 11:53:30
1.5K0
发布2018-02-05 11:53:30
举报
文章被收录于专栏:分享达人秀分享达人秀

上一期学习的Spinner的使用,掌握的怎么样?本期一起来学习AutoCompleteTextView的使用。

一、认识AutoCompleteTextView

AutoCompleteTextView是自动完成文本框,从EditText派生而出,实际上它也是一个文本编辑框,但它比普通编辑框多了一个功能:当用户输入一定字符之后,自动完成文本框会显示一个下拉菜单,供用户从中选择,当用户选择某个菜单项之后,AutoCompleteTextView按用户选择自动填写该文本框。

AutoCompleteTextView除了可使用EditText提供的XML属性和方法之外,还支持如下表所示的常用XML属性及相关方法。

XML属性

相关方法

说明

android:completionHint

setCompletionHint(CharSequence)

设置出现在下拉菜单中的提示标题

android:completionThreshold

setThreshold(int)

设置用户至少输入几个字福才会显示提示

android:dropDownHeight

setDropDownHeight(int)

设置下拉菜单的高度

android:dropDownHorizontalOffset

设置下拉菜单与文本框之间的水平偏移,下拉菜单默认与文本框左对齐

android:dropDownVerticalOffset

设置下拉菜单与文本框之间的垂直偏移,下拉菜单默认紧跟文本框

android:dropDownWidth

setdropDownWidth(int)

设置下拉菜单的宽度

android:popupBackground

setDropDownBackgroundResource(int)

设置下拉菜单的背景

使用AutoCompleteTextView很简单,只要为它设置一个Adapter即可,该Adapter封装了 AutoCompleteTextView预设的提示文本。

AutoCompleteTextView还派生了一个子类:MultiAutoCompleteTextView,该子类的功能与 AutoCompleteTextView基本相似,只是MultiAutoCompleteTextView允许输入多个提示项,多个提示项以分隔符分隔。MultiAutoCompleteTextView提供了 setTokenizer()方法来设置分隔符。

二、AutoCompleteTextView示例

接下来通过一个简单的示例程序来学习AutoCompleteTextView和MultiAutoCompleteTextView的使用方法。

继续使用WidgetSample工程的listviewsample模块,在app/main/res/layout/目录下创建autocomplete_textview_layout.xml文件,在其中填充如下代码片段:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:orientation="vertical"
              android:layout_width="match_parent"
              android:layout_height="match_parent">


    <!-- 定义一个自动完成文本框,指定输入一个字符后进行提示 -->
    <AutoCompleteTextView
        android:id="@+id/auto_actv"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="输入联系人姓名"
        android:completionHint="选择联系人"
        android:dropDownHorizontalOffset="10dp"
        android:completionThreshold="1"/>


    <!-- 定义一个MultiAutoCompleteTextView组件 -->
    <MultiAutoCompleteTextView
        android:id="@+id/mauto_mactv"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="输入联系人姓名,可多个分隔符分隔"
        android:completionThreshold="1"/>
</LinearLayout>

上面的界面布局文件中定义了 AutoCompleteTextView 和 MultiAutoCompleteTextView,接下来在程序中为它们绑定同一个Adapter,这意味着两个自动完成文本框的提示项完全相同,只是它们的表现行为略有差异。

新建AutoCompleteTextViewActivity.java文件,加载上面新建的布局文件,具体代码如下:

package com.jinyu.cqkxzsxy.android.listviewsample;


import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.ArrayAdapter;
import android.widget.AutoCompleteTextView;
import android.widget.MultiAutoCompleteTextView;


public class AutoCompleteTextViewActivity extends AppCompatActivity {
    private AutoCompleteTextView mAutoTv = null;
    private MultiAutoCompleteTextView mMultiAutoTv = null;


    // 定义字符串数组,作为提示的文本
    private String[] mContacts = new String[]{
            "test", "abc", "aaa", "aabbcc", "bac", "ok", "say", "aabbsd"
    };


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.autocomplete_textview_layout);

        mAutoTv = (AutoCompleteTextView)findViewById(R.id.auto_actv);
        mMultiAutoTv = (MultiAutoCompleteTextView)findViewById(R.id.mauto_mactv);


        // 创建一个ArrayAdapter,封装数组
        ArrayAdapter<String> aa = new ArrayAdapter<String>(this,
                android.R.layout.simple_dropdown_item_1line, mContacts);


        // 设置Adapter
        mAutoTv.setAdapter(aa);
        mMultiAutoTv.setAdapter(aa);


        // 为MultiAutoCompleteTextView设置分隔符
        mMultiAutoTv.setTokenizer(new MultiAutoCompleteTextView.CommaTokenizer());
    }
}

上面程序代码负责为AutoCompleteTextView、MultiAutoCompleteTextView 设置同一个 Adapter,并为 MultiAutoCompleteTextView 设置了分隔符。

修改程序启动的Activity,运行程序,可以看到下图所示界面效果。

分别在两个输入框输入内容,可以看到如下图所示效果。

至此,关于AutoCompleteTextView和MultiAutoCompleteTextView的简单使用学习完毕,更多属性和方法建议多加练习并掌握。

本文参与 腾讯云自媒体分享计划,分享自微信公众号。
原始发表:2017-08-27,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 分享达人秀 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档