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中的，使用代碼也能夠從三篇文章中找獲得，歡迎你們提供建議。