记录：AutoCompleteTextView的简单使用

摘要 ： 在地图的搜索工能中，看见官方demo使用 AutoCompleteTextView。觉得很要简便快捷。对其大致的使用记录一下。内容照抄值多片文章，原文在后面以参考链接的方式呈现。

  首先，还是列出一张截图和 AutoCompleteTextView 自生的几个属性：

  定义自身定义的 attrs：

<declare-styleable name="AutoCompleteTextView">
        <attr name="completionHint" format="string" />
        <attr name="completionHintView" format="reference" />
        <attr name="completionThreshold" format="integer" min="1" />
        <attr name="dropDownSelector" format="reference|color" /
        <attr name="dropDownAnchor" format="reference" />
        <attr name="dropDownWidth" format="dimension">
            <enum name="fill_parent" value="-1" />
            <enum name="match_parent" value="-1" />
            <enum name="wrap_content" value="-2" />
        </attr>
        <attr name="dropDownHeight" format="dimension">
            <enum name="fill_parent" value="-1" />        
            <enum name="match_parent" value="-1" />
            <enum name="wrap_content" value="-2" />
        </attr>
        <attr name="inputType" />
    </declare-styleable>

  其大致的意思和对应的方法：

属性	对应方法	描述
android:completionHint	setCompletionHint(CharSequence)	设置下拉菜单中的提示标题
android:completionHintView		设置下拉菜单中提示标题的视图
android:completionThreshold	setThreshold(int)	设置用户至少输入几个字符才会显示提示。默认为 2 个
android:dropDownSelector		设置选中的item背景色
android:dropDownAnchor	setDropDownAnchor(int id)	它的值是一个View的ID，指定后，AutoCompleteTextView会在这个View下弹出自动提示。
android:dropDownWidth		设置自动提示列表的宽度。
android:dropDownHeight		设置自动提示列表的高度。
原属性之外的几个常用方法
android:dropDownHorizontalOffest		设置下拉菜单与文本框之间的水平偏移，下拉菜单默认与文本框左对齐
adnroid:dropDownVerticalOffest		设置下拉菜单与文本框之间的垂直偏移，下拉菜单默认紧跟文本框
android:popupBackground	setDropDownBackgroundResource(int)	设置下拉菜单的背景

  下列的图片截图展示各个属性对 控件的不同显示。   默认的 AutoCompleteTextView

  设置一个值设置 android:completionHint ,可以看出 再输入 2 个字母的时候，弹出pop，pop的位置紧靠在搜索框的下面，pop 的背景颜色为默认（白色），选中 item 的时候，item的颜色也为默认。


  设置 自定义的 提示样式 android:completionHintView 和 背景 颜色android:popupBackground



  设置多少个字开始搜索 android:completionThreshold



  设置选中 item的颜色 android:dropDownSelector



  设置显示在那个 view 下 android:dropDownAnchor



  设置 显示pop 的宽度，高度一样 android:dropDownWidth



  设置控件里 view的垂直距离，水平一样。adnroid:dropDownVerticalOffest

  在使用android:completionHintView 会在设置后，并没有呈现出自己所设的 样式而困惑。具体原因见下面一段源码，就会明了：

public void setCompletionHint(CharSequence hint) {
        mHintText = hint;
        if (hint != null) {
            if (mHintView == null) {
                final TextView hintView = (TextView) LayoutInflater.from(getContext()).inflate(
                        mHintResource, null).findViewById(com.android.internal.R.id.text1);
                hintView.setText(mHintText);
                mHintView = hintView;
                mPopup.setPromptView(hintView);
            } else {
                mHintView.setText(hint);
            }
        } else {
            mPopup.setPromptView(null);
            mHintView = null;
        }
    }

  发现其使用的是系统的 id text1 findViewById(com.android.internal.R.id.text1),我们需要把自己 pop提示的标题 textView 的 id 设置为系统系统 id android:id="@android:id/text1"。 而且，还查看到要想使用 completionHintView 必须是在 mHintText 不为空的情况下，也就是 pop 的标题不为空时，才会显示出来，不会在没有文字的时候，显示空白格。

  AutoCompleteTextView 的内容是通过 adapter 的方式进行内容填充。既然是通过 adapter 的方式，我们也可以自定义 adapter 去实现自己想要的。其中需要注意的就是 自定义的 adapter 必须 implements Filterable 接口。

public interface Filterable {

    Filter getFilter();
}

    @SuppressWarnings({ "UnusedDeclaration" })
    protected void performFiltering(CharSequence text, int keyCode) {
        mFilter.filter(text, this);
    }

  public <T extends ListAdapter & Filterable> void setAdapter(T adapter) {
        if (mObserver == null) {
            mObserver = new PopupDataSetObserver();
        } else if (mAdapter != null) {
            mAdapter.unregisterDataSetObserver(mObserver);
        }
        mAdapter = adapter;
        if (mAdapter != null) {
            //noinspection unchecked
            mFilter = ((Filterable) mAdapter).getFilter();
            adapter.registerDataSetObserver(mObserver);
        } else {
            mFilter = null;
        }

        mPopup.setAdapter(mAdapter);
    }

  数据是通过 filterrable来筛选的，但是 performFiltering 方法是 protected 方法。可以继承 AutocompleteTextView来手动调用 performFiltering( )来触发过滤。代码如下：

public class AreaAutoCompleteTextView extends AutoCompleteTextView {
    public void filterText(){
        performFiltering(getText(), KeyEvent.KEYCODE_UNKNOWN) ;
    }
}

  对于 filterable 的实现，我们可以从 ArrayAdapter 中查看。下面看一下网上一个通过自定义 adapter，实现全员的模糊查询，并不是 ArrayAdapter 中的只匹配开始是符相同。

  在后面的时候，如果数据是字母的话，就会出现java.lang.StringIndexOutOfBoundsException: length=8; regionStart=0; regionLength=-1。其截图如下，求助各位大大，知道的在评论里面，告诉一下。找你！！先，谢谢。。
  自己发现的错误有，一是：在输入一段字符，删除一部分，重新输入一些。要是没有输入正确会错误。二是：在输入后选定某一条后，删除会直接报错

  倒数第 3 个正确的自定 adapter 实现搜索。修改 ArrayAdapter的部分有如下几处：

/**第一步： 输入的关键字 **/
private String indexStr;

//第二部： 自定义 Filter中的匹配条件修改为 contains（），原始为 startsWith（）
if (words[k].contains(prefixString)) {
                                newValues.add(value);
                                break;
                            }

//第三步：在createViewFromResource（）方法中，修改了 文字的显示样式
    if (item instanceof CharSequence) {
            if (indexStr != null) {
                String strAll = ((CharSequence) item).toString();
                String strBefore = strAll.substring(0, strAll.indexOf(indexStr));
                String strAfter = strAll.substring(strAll.indexOf(indexStr) + indexStr.length());
                text.setText(Html.fromHtml(strBefore + "<u><font color= 'red' type='bold'>" + indexStr + "</font></u>" + strAfter));
            } else {
                text.setText((CharSequence) item);
            }
        } else {
            if (indexStr != null) {
                String strAll = item.toString();
                String strBefore = strAll.substring(0, strAll.indexOf(indexStr));
                String strAfter = strAll.substring(strAll.indexOf(indexStr) + indexStr.length());
                text.setText(Html.fromHtml(strBefore + "<u><font color= 'red' type='bold'>" + indexStr + "</font></u>" + strAfter));
            } else {
                text.setText(item.toString());
            }
        }
//第四部：在自定义Filter中，给 indexStr 赋值为搜索框的内容
//将关键字保存  
indexStr = prefixString;

参考链接

• AutoCompleteTextView的使用及属性详解
• http://blog.youkuaiyun.com/u012338845/article/details/39577971
• 
  
• AutoCompleteTextView控件自定义下拉框背景，点击效果，字体显示效果，匹配条件等效果
• http://blog.youkuaiyun.com/kshw123/article/details/175292
• 
  
• Android AutoCompleteTextView completionHintView使用
• http://blog.sina.com.cn/s/blog_783ede030101dqiy.html
• 
  
• 自定义autoCompleteTextView实现自己的匹配规则
• http://www.tuicool.com/articles/BBfYjar
• 
  
• Android自定义View——自定义搜索框（SearchView）
• http://blog.youkuaiyun.com/jdsjlzx/article/details/46514761