Android 中文 API （22） —— MultiAutoCompleteTextView

正文

　　一、結構

　　　　public class MultiAutoCompleteTextView extends AutoCompleteTextView

　　　　java.lang.Object

　　　　　　android.view.View

　　　　　　　　android.widget.TextView

　　　　　　　　　　android.widget.EditText

　　　　　　　　　　　　android.widget.AutoCompleteTextView

                             　  　　android.widget.MultiAutoCompleteTextView

　　二、 類概述

　　一個繼承自AutoCompleteTextView的可編輯的文本視圖，能夠對用戶鍵入的文本進行有效地擴充提示，而不需要用戶輸入整個內容。（用戶輸入一部分內容，剩下的部分系統就會給予提示）。

　　用戶必須提供一個MultiAutoCompleteTextView.Tokenizer以用來區分不同的子串。

下面的代碼片段展示了如何創建一個文本視圖，這個視圖用來對用戶輸入的國家名稱進行有效地補充提示。

　　三、公共方法
 

         public boolean enoughToFilter ()

    此方法並不是檢驗什麼時候文本的總長度超過了預定的值，而是在僅當從函數findTokenStart（）到getSelectionEnd()函數得到的文本長度為0或者超過了預定值的時候才起作用。（譯者注：當文本長度超過阈值時過濾）

         public void performValidation ()

         此子類方法並不是用來確定整個文本的有效性，而是用來確定文本中的單個符號的有效性。空標記將被移除。

         public void setTokenizer (MultiAutoCompleteTextView.Tokenizer t)

         設置用來決定用戶正在輸入文本的范圍的分詞組件。

　　四、 受保護方法
 

         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          下拉列表裡的選中項 

轉自：http://www.cnblogs.com/over140/archive/2010/10/29/1864133.html