Android基本组件（四） - 快车库

第四组UI组件：AdaptView及子类：

AdaptView派生的AdbListView、AbsSpiner、AdapterViewAnimator依然是抽象类，实际使用的是他们的子类。

1.ListView、用于显示简单的列表。
下面是XML代码：

<!--    entries指定一个数组资源 -->
<!--    divider设置list列表项的分割条的颜色 -->
<!--    dividerHeight设置分割条的宽度 -->
<ListView
    android:id="@+id/listView1"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:entries="@arry/City"
    android:divider="#f0f"
    android:dividerHeight="2px" >
</ListView>

补充： android:entries="@arry/City"用到了数组资源，在values文件夹下加载resources 的 XML文件。

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <String-array>
        <item>厦门</item>
        <item>上海</item>
        <item>北京</item>
        <item>广州</item>
    </String-array>
</resources>

(1).这段的内容也是基于ListView，由于ListView 的 XML 代码能定制的内容很少，通过 android:entries 只能设置简单的列表项。想进行外观，行为定制就要通过Adapter来提供列表项。
Adapter 本身就是接口，它提供的实现类有a、ArrayAdapter，b、SimppleAdapter，c、SimpleCursorAdapter,d、BaseAdapter。

a、使用ArrayAdapter创建ListView:
下面是XML代码：

<!-- 设置使用红色的分隔条 -->
<ListView  
    android:id="@+id/list1"
    android:layout_width="fill_parent" 
    android:layout_height="wrap_content" 
    android:divider="#f00"
    android:dividerHeight="2px"
    android:headerDividersEnabled="false"
    />

补充1:
可一注意到ListView没有指定的 android：entries 属性，这意味这它要通过Java代码来提供列表项:
下面是Activity的Java代码：

        ListView list1 = (ListView) findViewById(R.id.list1);
        // 定义一个数组
        String[] arr1 = { "孙悟空", "猪八戒", "牛魔王" };
        // 将数组包装ArrayAdapter
        ArrayAdapter<String> adapter1 = new ArrayAdapter<String>
            (this, R.layout.array_item, arr1);
        // 为ListView设置Adapter
        list1.setAdapter(adapter1);

其中ArrayAdapter的三个参数：
ArrayAdapter adapter1 = new ArrayAdapter(Context,textViewResourceld, list);
Context：上下文
textViewResourceld：一个资源ID，该ID代表一个TextView
List:该数组为列表项提供数据

补充2.
textViewResourceld用到的ID资源是R.layout.array_item，XML代码如下：

<TextView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/TextView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"    
    android:textSize="24dp"
    android:padding="10px"
    android:shadowColor="#f0f"
    android:shadowDx="4"
    android:shadowDy="4"
    android:shadowRadius="2"/>

b、使用SimpleAdapter创建ListView：
上面的ArrayAdapter的功能比较局限，每个列表项只能是TextView。实现更复杂的功能就要用到SimpleAdapter。
这部分不大好写，整的来说就是SimpleAdapter可加载的列表项不像上面那样单单是一个TextView，而是可加载整个XML的布局文件，布局文件里面可以有 ImageView，TextView等等...
先看XML的布局文件，R.layout.simple_item代码如下：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
<!-- 定义一个ImageView，用于作为列表项的一部分。 -->
<ImageView android:id="@+id/header"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" 
    android:paddingLeft="10dp"
    />
<!-- 定义一个TextView，用于作为列表项的一部分。 -->
<TextView android:id="@+id/name"
    android:layout_width="wrap_content" 
    android:layout_height="wrap_content"
    android:textSize="20dp"
    android:textColor="#f0f"
    android:paddingLeft="10dp"
    />
</LinearLayout>

然后在写过JAVA代码将上面的布局文件给加载进去：

public class SimpleAdapterTest extends Activity
{
    private String[] names = new String[]
        { "虎头", "弄玉", "李清照", "李白"};
    private int[] imageIds = new int[]
        { R.drawable.tiger , R.drawable.nongyu
        , R.drawable.qingzhao , R.drawable.libai};

    @Override
    public void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        // 创建一个List集合，List集合的元素是Map
        List<Map<String, Object>> listItems = 
                new ArrayList<Map<String, Object>>();
        for (int i = 0; i < names.length; i++)
        {
            Map<String, Object> listItem = new HashMap<String, Object>();
            listItem.put("header", imageIds[i]);
            listItem.put("personName", names[i]);
            listItem.put("desc", descs[i]);
            listItems.add(listItem);
        }
        // 创建一个SimpleAdapter
        SimpleAdapter simpleAdapter = new SimpleAdapter(this, listItems,
            R.layout.simple_item, 
            new String[] { "personName", "header" },
            new int[] { R.id.name, R.id.header  });
        ListView list = (ListView) findViewById(R.id.mylist);
        // 为ListView设置Adapter
        list.setAdapter(simpleAdapter);

补充1：

List<Map<String, Object>> listItems = new ArrayList<Map<String, Object>>();

这里是创建一个List集合，关于这部分是JAVA的代码,可以参考JAVA-集合类概述（笔记）

补充2：

SimpleAdapter simpleAdapter = new SimpleAdapter(
this,     
listItems,
R.layout.simple_item, new String[] { "personName", "header" },
new int[] { R.id.name, R.id.header  });

对里面的参数做个介绍：
list ：上下文
listItems ：是一个List>类型的集合对象
R.layout.simple_item ：一个XML布局，就上面那部分
new String[] { "personName", "header" } ：用来生成列表项
new int[] { R.id.name, R.id.header } ：该参数决定填充哪些组件

c、扩展BaseAdapter实现不存储列表项的ListView：
使用BaseAdapter可以由开发者来决定创建多少个列表项，每个列表项的组件由开发者来决定。
XML布局就简单添加一个ListView ，此处不再给出，大家可以参考上面程序。
由JAVA文件来给ListView加载列表项，代码如下：

public class BaseAdapterTest extends Activity
{
    ListView myList;
    @Override
    public void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        myList = (ListView) findViewById(R.id.myList);
        BaseAdapter adapter = new BaseAdapter()
        {
            @Override
            public int getCount()
            {
                // 指定一共包含40个选项
                return 40;
            }
            @Override
            public Object getItem(int position)
            {
                return null;
            }
            // 重写该方法，该方法的返回值将作为列表项的ID
            @Override
            public long getItemId(int position)
            {
                return position;
            }
            // 重写该方法，该方法返回的View将作为列表框
            @Override
            public View getView(int position
                    , View convertView , ViewGroup parent)
            {
                // 创建一个LinearLayout，并向其中添加2个组件
                LinearLayout line = new LinearLayout(BaseAdapterTest.this);
                line.setOrientation(0);
                ImageView image = new ImageView(BaseAdapterTest.this);
                image.setImageResource(R.drawable.ic_launcher);
                TextView text = new TextView(BaseAdapterTest.this);
                text.setText("第" + (position +1 ) + "个列表项");
                text.setTextSize(20);
                text.setTextColor(Color.RED);
                line.addView(image);
                line.addView(text);
                // 返回LinearLayout实例
                return line;
            }
        };
        myList.setAdapter(adapter);
    }
}

补充：
getCount ：该方法返回值控制该Adapter将包含多少个列表项
getItem（int position） : 该方法的返回值决定第Poeition处的列表项的内容
getItemId（int position）：该方法返回的值将决定第position处的列表项ID
public View getView(int position, View convertView , ViewGroup parent) ：
该方法返回的值决定第position处列表项组件。

2.自动完成文本框（AutoCompleteTextView）的功能及其用法：
自动完成文本框（AutoCompleteTextView）从EditText派生出来的，但多了一个功能：当用户输入一定字符之后，自动完成文本框会显示一个下拉菜单。
下面是XML代码：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
<!-- 定义一个自动完成文本框，指定输入一个字符后进行提示 -->
<!-- android:completionHint设置下拉菜单懂得标题 -->
<!-- android:completionThreshold设置至少输入几个字符才会显示提示 -->

<AutoCompleteTextView  
    android:id="@+id/auto"
    android:layout_width="fill_parent" 
    android:layout_height="wrap_content" 
    android:completionHint="请选择您喜欢的图书："
    android:dropDownHorizontalOffset="10dp"
    android:completionThreshold="1"/>

<!-- 定义一个MultiAutoCompleteTextView组件 -->
<!-- MultiAutoCompleteTextView多了个功能及应许输入多个提示项 -->

<MultiAutoCompleteTextView
    android:id="@+id/mauto"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:completionThreshold="1"/>
</LinearLayout>

接下来为AutoCompleteTextView ，MultiAutoCompleteTextView 加载列表项
JAVA代码如下：

public class AutoCompleteTextViewTest extends Activity
{
    AutoCompleteTextView actv;
    MultiAutoCompleteTextView mauto;
    // 定义字符串数组，作为提示的文本
    String[] books = new String[]{
        "自学JAVA",
        "自学C++",
        "自学SQL",
        "自学Android"
    };
    @Override
    public void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        // 创建一个ArrayAdapter，封装数组
        ArrayAdapter<String> aa = new ArrayAdapter<String>(this,
            android.R.layout.simple_dropdown_item_1line, books);
        actv = (AutoCompleteTextView)findViewById(R.id.auto);
        // 设置Adapter
        actv.setAdapter(aa);
        mauto = (MultiAutoCompleteTextView)findViewById(R.id.mauto);
        // 设置Adapter
        mauto.setAdapter(aa);
        // 为MultiAutoCompleteTextView设置分隔符
        mauto.setTokenizer(new MultiAutoCompleteTextView.CommaTokenizer());
    }
}

下面还有几个组件，也都是用ArrayAdapter 、 SimppleAdapter 、 BaseAdapter。来加载列表项，有时间继续更新 . . .