Android
android.widget
public class

android.widget.MultiAutoCompleteTextView

java.lang.Object
android.view.View Drawable.Callback KeyEvent.Callback
android.widget.TextView ViewTreeObserver.OnPreDrawListener
android.widget.EditText
android.widget.AutoCompleteTextView Filter.FilterListener
android.widget.MultiAutoCompleteTextView

An editable text view, extending AutoCompleteTextView, that can show completion suggestions for the substring of the text where the user is typing instead of necessarily for the entire thing.

You must must provide a MultiAutoCompleteTextView.Tokenizer to distinguish the various substrings.

The following code snippet shows how to create a text view which suggests various countries names while the user is typing:

 public class CountriesActivity extends Activity {
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.autocomplete_7);
 
         ArrayAdapter adapter = new ArrayAdapter(this,
                 android.R.layout.simple_dropdown_item_1line, COUNTRIES);
         MultiAutoCompleteTextView textView = (MultiAutoCompleteTextView) findViewById(R.id.edit);
         textView.setAdapter(adapter);
         textView.setTokenizer(new MultiAutoCompleteTextView.CommaTokenizer());
     }

     private static final String[] COUNTRIES = new String[] {
         "Belgium", "France", "Italy", "Germany", "Spain"
     };
 }

Nested Classes
MultiAutoCompleteTextView.CommaTokenizer This simple Tokenizer can be used for lists where the items are separated by a comma and one or more spaces. 
MultiAutoCompleteTextView.Tokenizer  

Summary

XML Attributes inherited from class android.widget.AutoCompleteTextView
XML Attributes inherited from class android.widget.TextView
XML Attributes inherited from class android.view.View
Constants inherited from class android.view.View
Fields inherited from class android.view.View

Public Constructors

            MultiAutoCompleteTextView(Context context)
            MultiAutoCompleteTextView(Context context, AttributeSet attrs)
            MultiAutoCompleteTextView(Context context, AttributeSet attrs, int defStyle)

Public Methods

          boolean  enoughToFilter()
Instead of filtering whenever the total length of the text exceeds the threshhold, this subclass filters only when the length of the range from findTokenStart(CharSequence, int) to getSelectionEnd() meets or exceeds getThreshold().
          void  performValidation()
Instead of validating the entire text, this subclass method validates each token of the text individually.
          void  setTokenizer(MultiAutoCompleteTextView.Tokenizer t)
Sets the Tokenizer that will be used to determine the relevant range of the text where the user is typing.

Protected Methods

          void  performFiltering(CharSequence text, int keyCode)
Instead of filtering on the entire contents of the edit box, this subclass method filters on the range from findTokenStart(CharSequence, int) to getSelectionEnd() if the length of that range meets or exceeds getThreshold().
          void  performFiltering(CharSequence text, int start, int end, int keyCode)

Starts filtering the content of the drop down list.

          void  replaceText(CharSequence text)

Performs the text completion by replacing the range from findTokenStart(CharSequence, int) to getSelectionEnd() by the the result of passing text through terminateToken(CharSequence).

Methods inherited from class android.widget.AutoCompleteTextView
Methods inherited from class android.widget.EditText
Methods inherited from class android.widget.TextView
Methods inherited from class android.view.View
Methods inherited from class java.lang.Object
Methods inherited from interface android.graphics.drawable.Drawable.Callback
Methods inherited from interface android.view.KeyEvent.Callback
Methods inherited from interface android.view.ViewTreeObserver.OnPreDrawListener
Methods inherited from interface android.widget.Filter.FilterListener

Details

Public Constructors

public MultiAutoCompleteTextView(Context context)

public MultiAutoCompleteTextView(Context context, AttributeSet attrs)

public MultiAutoCompleteTextView(Context context, AttributeSet attrs, int defStyle)

Public Methods

public boolean enoughToFilter()

Instead of filtering whenever the total length of the text exceeds the threshhold, this subclass filters only when the length of the range from findTokenStart(CharSequence, int) to getSelectionEnd() meets or exceeds getThreshold().

public void performValidation()

Instead of validating the entire text, this subclass method validates each token of the text individually. Empty tokens are removed.

public void setTokenizer(MultiAutoCompleteTextView.Tokenizer t)

Sets the Tokenizer that will be used to determine the relevant range of the text where the user is typing.

Protected Methods

protected void performFiltering(CharSequence text, int keyCode)

Instead of filtering on the entire contents of the edit box, this subclass method filters on the range from findTokenStart(CharSequence, int) to getSelectionEnd() if the length of that range meets or exceeds getThreshold().

Parameters

text the filtering pattern
keyCode the last character inserted in the edit box

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

Starts filtering the content of the drop down list. The filtering pattern is the specified range of text from the edit box. Subclasses may override this method to filter with a different pattern, for instance a smaller substring of text.

protected void replaceText(CharSequence text)

Performs the text completion by replacing the range from findTokenStart(CharSequence, int) to getSelectionEnd() by the the result of passing text through terminateToken(CharSequence). In addition, the replaced region will be marked as an AutoText substition so that if the user immediately presses DEL, the completion will be undone. Subclasses may override this method to do some different insertion of the content into the edit box.

Parameters

text the selected suggestion in the drop down list
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:48