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

上一期学习的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的简单使用学习完毕,更多属性和方法建议多加练习并掌握。

原文发布于微信公众号 - 分享达人秀(ShareExpert)

原文发表时间:2017-08-27

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏葡萄城控件技术团队

Spread for Windows Forms高级主题(6)---数据绑定管理

自定义列和区域的数据绑定 当表单被绑定到一个数据集时,表单中的列就会相继的被分配到数据集的区域上。例如,第一个数据域分配给列A,第二个数据区域分配给列B,等等。...

220100
来自专栏前端vue

SimpleMDE - Vue-Markdown编辑器

49520
来自专栏AndroidTv

关于RecyclerView你知道的不知道的都在这了(下)目录正文

26630
来自专栏上善若水

035android初级篇之[转]android的ViewGroup与View

Android中的View包含了用户交互和显示,类似于Windows操作系统中的window。

10430
来自专栏程序员叨叨叨

Android大坑集锦

这些方法有的可以,有的不行,或许跟版本有关,或许Android本身不是很支持用setImageUri从网上获取图片吧!与其煞费苦心让这个方法有效,不如用Imag...

8640
来自专栏君赏技术博客

Jekyll-Admin-Mac 开发纪要-左侧菜单栏

本文章文字大约 4500字,大概花费 10分钟阅读。本文章设计的图片比较多,流量党慎入!。

17610
来自专栏Android相关

LinearLayout.onMeasure--事例说明

将LinearLayout中代码Copy了一份存在本地,然后再在里面加了几个子View,打印出来LinearLayout.onMeasure中的那些变量的值

11320
来自专栏挖坑填坑

Asp.net+Vue2构建简单记账WebApp之六(vue.js构建记账统计页面)

19640
来自专栏何俊林

Android View框架总结(二)View焦点

前言:今天七夕节,笔者先祝大家七夕快乐,无论是否有女朋友,去吃一吨好吃的,年轻多努力才是王道。如果觉得笔者一直以来写的文章,有让你收获那么一点点。可以推荐此公众...

23780
来自专栏Android开发指南

10.多媒体

40680

扫码关注云+社区

领取腾讯云代金券