一步一步学android控件（之五） —— AutoCompleteTextView

android 控件众多 ， 额 ， 具体多少个呢？ 貌似有那么几十个吧，也没做个统计，嘿嘿！......
有木有朋友感觉写了那么长时间的android代码，有时候想写点自己的东西的时候却发现自己好像离不开网络耶，什么都需要先到网络上遨游一番才能解决自己的问题。思前想后，个人觉得还是有必要巩固一下自己学习过的东西——想想以前这些东西，自己都写过一遍了，但是折腾一段时间下来都不知道放哪里去了........

好了，废话不多说了，这次准备重新学习一下android的常用控件TextView、EditText、AutoCompleteTextView、Button、CalendarView、CheckBox、Chronometer、CompoundButton、DatePicker、DigitalClock、ExpandableListView、Gallery、GridView、HorizontalScrollView、ImageButton、ImageSwitcher、ImageView、ListPopupWindow、ListView、MultiAutoCompleteTextView、NumberPicker、PopupMenu、PopupWindow、ProgressBar、QuickContactBadge、RadioButton、RadioGroup、RatingBar、RemoteViews、ScrollView、SearchView、SeekBar、SlidingDarwer、Switch、TableHost、TextClock、TextSwitcher、TimePicker、Toast、ToggleButton、VideoView、ViewFlipper、ViewSwitcher、ZoomButton等控件。

今天学习的控件——AutoCompleteTextView ， AutoCompleteTextView控件的作用是什么呢？ AutoComplete（自动完成），这里大家叫他自动补全—— 当在EditText中输入字符时他将去去一个集合中搜索出满足条件的项，然后列出这些项。在官方文档里给的例子是这样的

public class CountriesActivity extends Activity {
     protected void onCreate(Bundle icicle) {
         super.onCreate(icicle);
         setContentView(R.layout.countries);

         ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
                 android.R.layout.simple_dropdown_item_1line, COUNTRIES);
         AutoCompleteTextView textView = (AutoCompleteTextView)
                 findViewById(R.id.countries_list);
         textView.setAdapter(adapter);
     }

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

好吧，今天就按照这个样例简单实现AutoCompleteTextView，只不过我们要将这里的COUNTIES 换成我们自己想要的内容——在这里我们关心的是整个系统中的文件名称。

先看看效果图：

下面就一步一步来实现上述功能

1、准备必须的布局文件——auto_complete_textview_detail.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <AutoCompleteTextView
        android:id="@+id/show_auto_complete_textview"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_margin="10dp">
        <requestFocus />
    </AutoCompleteTextView>

</LinearLayout>

该文件中只包含一个View ——AutoCompleteTextView 。

2、 创建activity ——WidgetAutoCompleteActivity.java

package com.xy.zt.selfdefinewieget;

import java.io.File;
import java.util.ArrayList;
import java.util.LinkedList;

import android.app.Activity;
import android.os.AsyncTask;
import android.os.Bundle;
import android.os.Environment;
import android.widget.ArrayAdapter;
import android.widget.AutoCompleteTextView;

public class WidgetAutoCompleteActivity extends Activity {
    private AutoCompleteTextView mShowAuto;
    private ArrayAdapter<String> mAutoAdapter;

    private class FileSearchTask extends AsyncTask<Void, Void, String[]> {

        @Override
        protected void onPostExecute(String[] result) {
            if (result == null || result.length == 0) {
                return;
            }
            mShowAuto.setEnabled(true);
            if (mAutoAdapter == null) {
                mAutoAdapter = new ArrayAdapter<String>(
                        WidgetAutoCompleteActivity.this,
                        android.R.layout.simple_dropdown_item_1line, result);
                mShowAuto.setAdapter(mAutoAdapter);
            }
        }

        @Override
        protected String[] doInBackground(Void... params) {
            File rootDir = Environment.getRootDirectory();
            LinkedList<File> queue = new LinkedList<File>();
            ArrayList<String> result = new ArrayList<String>();
            queue.offer(rootDir);
            File tmpFile, tmpDirAllFile[];
            while ((tmpFile = queue.poll()) != null) {
                if (tmpFile.isDirectory()) {
                    tmpDirAllFile = tmpFile.listFiles();
                    if (tmpDirAllFile != null) {
                        for (File f : tmpDirAllFile) {
                            queue.offer(f);
                        }
                    }
                } else {
                    result.add(tmpFile.getName());
                }
            }
            String[] tmpFileNames = new String[result.size()];
            result.toArray(tmpFileNames);
            result.clear();
            result = null;
            queue = null;
            return tmpFileNames;
        }

    }

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.auto_complete_textview_detail);
        init();
        new FileSearchTask().execute();
    }

    private void init() {
        mShowAuto = (AutoCompleteTextView) findViewById(R.id.show_auto_complete_textview);
        mShowAuto.setEnabled(false);
        mShowAuto.setThreshold(1);
    }
}

这个文件处理了所有想要做的事，在OnCreate函数中 new FileSearchTask().execute(); 启动一个异步线程在后台例举出所有的文件名称（在这个过程中AutoCompleteTextView是不可用的），加载完成后准备Adapter 

mAutoAdapter = new ArrayAdapter<String>(
                        WidgetAutoCompleteActivity.this,
                        android.R.layout.simple_dropdown_item_1line, result);
                mShowAuto.setAdapter(mAutoAdapter);

由于AutoCompleteTextView默认是最少两个字符才进行处理， 想要输入一个字符就进行处理——加入下面这句话

mShowAuto.setThreshold(1);

3、重点已经完成，下面就添加剩余的代码以符合整个工程的架构。

3.1 在ViewData中加入如下内容

    public static final int AUTO_COMPLETE_TEXTVIEW_ID = EDIT_TEXT_ID +1 ;
    public static final String AUTO_COMPLETE_TEXTVIEW_NAME = "AutoCompleteTextView";
    private static final ViewData mAutoCompleteTextView = new ViewData(AUTO_COMPLETE_TEXTVIEW_NAME, AUTO_COMPLETE_TEXTVIEW_ID);
    View_Datas.add(mAutoCompleteTextView);

3.2 在WidgetsAdapter的handleItemClicked 函数中添加如下内容：

case ViewData.AUTO_COMPLETE_TEXTVIEW_ID:
            intent.setClass(mContext, WidgetAutoCompleteActivity.class);
            mContext.startActivity(intent);
            break;

不想太死板，我想要更炫的效果，ok 满足你 ^_^！

首先修改上文中mAutoAdapter的构造

mAutoAdapter = new ArrayAdapter<String>(
                        WidgetAutoCompleteActivity.this,
                        R.layout.auto_complete_item, R.id.auto_item_file_name,result);

上面代码中看到使用了布局文件auto_complete_item和其内部定义的一个id叫auto_item_file_name的View，下面是文件内容

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <TextView
        android:id="@+id/auto_item_file_name"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceMedium"
        android:background="@drawable/widget_button_drawable"
        android:textColor="@color/auto_complete_font_color"
        android:paddingTop="10dp"
        android:paddingBottom="10dp"
        android:textSize="16sp" />

</LinearLayout>

注意：该布局中的TextView是必须的不能换成其他的View ， 否则将报ClassCastException。

TextView使用的背景Widget_button_drawable的定义参见一步一步学android控件（之三） —— Button   。TextView 使用的字体颜色是心添加的 ，定义在widget_color.xml文件中

<color name="auto_complete_font_color">#FFCC00</color>

新的效果如下图

AutoCompleteTextView到这里就完了 ， 对后面的内容有不清楚的地方参见 点击打开一步一步学android控件（之一） —— 开始篇。 下一个控件MultiAutoCompleteTextView。