Android 中文 API （22） —— MultiAutoCompleteTextView

前言

　　本章内容是android.widget.MultiAutoCompleteTextView，翻译来自颖哥儿，再次感谢 颖哥儿 ！期待你一块儿参与Android API 的中文翻译，联系我over140@gmail.com。
 

 

声明

　　欢迎转载，但请保留文章原始出处:)
 

　　　　农民伯伯：http://over140.blog.51cto.com/

　　　　Android中文翻译组：http://www.cnblogs.com/over140/  

 

正文

　　1、结构

　　　　public class MultiAutoCompleteTextView extends AutoCompleteTextView

 
 

　　　　java.lang.Object

　　　　　　android.view.View

　　　　　　　　android.widget.TextView

　　　　　　　　　　android.widget.EditText

　　　　　　　　　　　　android.widget.AutoCompleteTextView

                             　  　　android.widget.MultiAutoCompleteTextView

 

　　2、 类概述

 

 

一个继承自AutoCompleteTextView的可编辑的文本视图，可以对用户键入的文本进行有效地扩充提示，而不须要用户输入整个内容。（用户输入一部份内容，剩下的部分系统就会给予提示）。

　　用户必须提供一个MultiAutoCompleteTextView.Tokenizer以用来区分不一样的子串。

下面的代码片断展现了如何建立一个文本视图，这个视图用来对用户输入的国家名称进行有效地补充提示。

　　

 

　　3、公共方法
 

 

         public boolean enoughToFilter ()

    此方法并非检验何时文本的总长度超过了预约的值，而是在仅当从函数findTokenStart（）到getSelectionEnd()函数获得的文本长度为0或者超过了预约值的时候才起做用。（译者注：当文本长度超过阈值时过滤）

 

         public void performValidation ()

         此子类方法并非用来肯定整个文本的有效性，而是用来肯定文本中的单个符号的有效性。空标记将被移除。

 

         public void setTokenizer (MultiAutoCompleteTextView.Tokenizer t)

         设置用来决定用户正在输入文本的范围的分词组件。

 
 

　　4、 受保护方法
 

 

         protected void performFiltering (CharSequence text, int keyCode)

此方法并不过滤整个编辑框的内容,只是过滤从函数findTokenStart() 到函数getSelectionEnd()得到的长度为0或者超过了预约的值的文本内容。

参数

text          指定过滤模式

keyCode           插入到编辑框中的最后一个字符；当字符（文本）是经过软键盘输入的时候，当心此字符的值可能为NULL。

 

         protected void performFiltering (CharSequence text, int start, int end, int keyCode)

         启动对下拉式列表内容的过滤。过滤模式为编辑框中指定的范围。子类可覆盖此方法，以便于采用一个不一样的模式。

 

         protected void replaceText (CharSequence text)

    经过替换从函数findTokenStart() 到函数 getSelectionEnd()获得的文本文本范围以及传递给函数terminateToken()的文版返回的结果来实现文本的输入。另外，文本的替换区域将会被标记为自动文本区，这样若是用户直接按DEL键，执行过程就会中止。子类可覆盖此方法来实现许多不一样的文本插入工做。

参数

　　　　　　 text          下拉列表里的选中项 

 

　　5、补充
 

　　　　5.1　　相关文章连接

　　　　　　Android控件之AutoCompleteTextView、MultiAutoCompleteTextView探究

　　　　　　AutoCompleteTextView和MultiAutoCompleteTextView

　　　　　　Auto Complete Text

 

结束
 

　　文章图片使用的是文章3中的，使用代码也能够从三篇文章中找获得，欢迎你们提供建议。