Android开发10.1：UI组件适配器AdapterView(创建ListView,Adapter接口)-更新20130912

@version：Android4.3 API18

@author：liuxinming

概述

              AdapterView继承了ViewGroup，它的本质是容器

              AdapterView 可以包含多个 “列表项”，并将多个“列表项”以合适的形式显示出来

              AdapterView显示的多个“列表项”由Adapter提供

类图

ListView(列表视图)

ListView以垂直列表的形式显示所有列表项

创建方式：

                          1、直接使用ListView创建

                          2、让Activity继承ListActivity(相当于该Activity显示的组件为ListView)

在程序中获得了ListView之后，接下来就需要为ListView设置它要显示的列表项

注释：ListView、GridView、Spinner、Gallery等AdapterView都只是容器，而Adapter负责提供每个“列表项”组件，AdapterView则负责采用合适的方式显示这些列表项。

XML属性

AbsListView属性

官方API参考
http://developer.android.com/reference/android/widget/AbsListView.html

XML属性	相关方法	说明
android:choiceMode		设置AbsListView的选择行为，支持下列属性值 none:不显示任何选中项 value=0 singleChoice：允许单选 value=1 multipleChoice：允许多选 value=2 multipleChoiceModal：允许多选 value=3
android:DrawSelectorOnTop	setDrawSelectoronTop(boolean)	true：选中的列项将会显示在上面
android:fastScrollEnabled		设置是否允许快速滚动 true：显示滚动图标,并允许用户拖动该滚动图标进行快速滚动
android:listSelector	setSelector(int)	指定被选中的列表项上绘制的Drawable
android:scrollingCache		true：该组件在滚动时将会使用绘制缓存
android:smoothScrollbar	setSmoothScrollbarEnable(boolean)	false：则不在header View之后绘制分割线
android:stackFromBottom		设置是否从底端开始排列列表项
android:textFilterEnable		设置是否对列表项进行过滤 注释：当该AbsListView对应的Adapter实现了Filter接口时该属性才会起作用
android:transcriptMode		设置该组件的滚动模式。该属性支持如下属性 disabled：关闭滚动。默认值 normal：当该AbsListView受到数据改变通知，且最后一个列表项可见时，该AbsListView将会滚动到底端 alwaysScroll：该AbsListView总会自动滚动到底端

ListView常用XML属性

android:divider	设置List列表项的分割线（即可用颜色分割，也可用Drawable分割）
android:dividerHeight	分割线的高度
android:entries	指定一个数组资源，Android将根据该数组资源来生成ListView
android:footerDividersEnabled	false：则不在footer View之前绘制分隔线
android:headerDividersEnabled	false：则不在header View之后绘制分隔线

使用数组创建ListView实例

Android_ListView/res/layout/activity_main.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
 >
    <!-- 使用数组资源给出列表项 -->
    <ListView 
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:entries="@array/code"
        android:divider="#f00"
        android:dividerHeight="2dp"
        android:headerDividersEnabled="false"
        />
</LinearLayout>

Android_ListView/res/values/arrays.xml

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <string-array name="code">
        <item>Android</item>
        <item>PHP</item>
        <item>Java</item>
        <item>C</item>
        <item>C++</item>
    </string-array>
</resources>

调试效果

这是一个比较简单的案例，这种方式创建ListView能定制的内容很少

Adapter(接口)

     Adapter本身只是一个接口

     它派生了ListAdapter和SpinnerAdapter两个子接口，其中ListAdapter为AbsListView提供列表项，而SpinnerAdapter为AbsSpinner提供列表项

接口及其实现类的继承关系类图

    接口间接类较多，可能画的有点凌乱，我整理了很几次，看着也好像有点凌乱，呵呵。凑活着看吧

    官方API参考：
    http://developer.android.com/reference/android/widget/Adapter.html

Adapter常用的实现类

1、ArrrayAdapter：简单、易用，通常用于数组或List集合的多个值包装成多个列表项

2、SimpleAdapter：功能有点强，可用于将List集合的多个对象包装成多个列表项

3、SimpleCursorAdapter：与SimpleAdapter基本相似，只是用于包装Cursor提供的数据

4、BaseAdapter：通常用于被扩展。扩展BaseAdapter可以对各列表项进行最大限度的定制

实现类一：ArrayAdapter实例

    设计场景：通过界面布局定义两个ListView,但这两个ListView都不指定android:entries属性（哈哈，区别来啦，前面一个简单例子，我们是通过配置XML数组资源）

                        我们通过Activity为两个ListView提供Adapter，Adapter来控制所显示的列表项

                        注释：这个有点像WEB开发的模板机制，定义好数据格式后，通过后端程序来控制数据资源需要显示的内容。

    Android_ListView/layout/Activity_main.xml

    

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
 >
    <!-- 定义两个ListView -->
    <ListView 
        android:id="@+id/list01"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:divider="#f00"
        android:dividerHeight="2dp"
        android:headerDividersEnabled="false"
        />
    <ListView 
        android:id="@+id/list02"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:divider="#f00"
        android:dividerHeight="2dp"
        android:headerDividersEnabled="false"
        />
</LinearLayout>

 Android_ListView/res/layout/array_item.xml

<?xml version="1.0" encoding="UTF-8"?>
<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="24sp"
    android:padding="10dp"
    android:shadowColor="#f0f"
    android:shadowDx="4"
    android:shadowDy="4"
    android:shadowRadius="2"
    />

Android_ListView/res/layout/checked_item.xml

<?xml version="1.0" encoding="utf-8"?>
<CheckedTextView
	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="24sp"
	android:checkMark="@drawable/ok"
	android:shadowColor="#f0f"
	android:shadowDx="4"
	android:shadowDy="4"
	android:shadowRadius="2"/>

Android_ListView/src/com/example/android_listview/MianActiviy.java

package com.example.android_listview;

import android.os.Bundle;
import android.app.Activity;
import android.view.Menu;
import android.widget.ArrayAdapter;
import android.widget.ListView;

public class MainActivity extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		ListView list01 = (ListView) findViewById(R.id.list01);
		ListView list02 = (ListView) findViewById(R.id.list02);
		//定义数组
		String[] data1 = {"屌丝","高富帅","白富美"};
		String[] data2 = {"Android","PHP","Java","C","C++"};
		
		//将数组包装为ArrayAdapter
		ArrayAdapter<String> adapter1 = new ArrayAdapter<String>
		(this,R.layout.array_item,data1);
		ArrayAdapter<String> adapter2 = new ArrayAdapter<String>
		(this,R.layout.checked_item,data2);
		
		//为ListView 设置 Adapter
		list01.setAdapter(adapter1);
		list02.setAdapter(adapter2);
	}

	@Override
	public boolean onCreateOptionsMenu(Menu menu) {
		// Inflate the menu; this adds items to the action bar if it is present.
		getMenuInflater().inflate(R.menu.main, menu);
		return true;
	}

}

调试效果

 知识点：

               ArrayAdapter<String> adapter1 = new ArrayAdapter<String>
(this,R.layout.array_item,data1)

             创建ArrayAdapter时必须指定的三个参数：
             1、Context：代表了访问整个Android应用的接口。

             2、textViewResourceld：一个资源ID，该资源ID代表一个TextView，该TextView组件将作为ArrayAdapter的列表项组件

             3、数组或List：该数组或List将负责为多个列表项提供数据

ListActivity实现列表

如果窗口仅仅需要显示一个列表，则可以直接让Activity继承ListActivity来实现，ListActivity的子类无需调用setContentView()方法来显示某个界面

而是可以直接传入一个内容Adapter,ListActivity子类就呈现出一个列表

Android_ListView/src/com/example/android_listview/MianActiviy.java

package com.example.android_listview;

import android.app.ListActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;

/**
 * @author  LiuxinMing [email protected]
 */
public class MainActivity extends ListActivity
{
	@Override
	public void onCreate(Bundle savedInstanceState)
	{
		super.onCreate(savedInstanceState);
		// 无需使用布局文件
		String[] arr = {"屌丝","高富帅","白富美"};
		// 创建ArrayAdapter对象
		ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
			android.R.layout.simple_list_item_multiple_choice, arr);
		// 设置该窗口显示列表
		setListAdapter(adapter);
	}
}

调试效果：

实现类二：SimpleAdapter创建ListView

实现步骤

                 1、先在界面布局中定义一个ListVew(该ListView将会显示由SimpleAdapter提供的列表项)

                 2、创建一个list集合(可选)

                 3、创建SimpleAdapter

                 4、为ListView设置Adapter

Android_SimpleAdapter/res/layout/activity_main.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    >
    <!-- 定义一个ListView -->
    <ListView 
        android:id="@+id/list01"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        />
</LinearLayout>

Android_SimpleAdatper/res/layout/simple_item.xml

<?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="100dp"
        android:layout_height="100dp"
        android:scaleType="centerCrop"
        android:paddingLeft="10dp"
        />
    <LinearLayout 
        android:orientation="vertical"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        >
        <!-- 定义一个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"
            />
        <!-- 定义一个TextView，用于作为列表项的一部分 -->
        <TextView android:id="@+id/desc"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:textSize="14dp"
            android:paddingLeft="10dp"
            />
    </LinearLayout>
</LinearLayout>

activity代码

package com.example.android_simpleadapter;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import android.os.Bundle;
import android.app.Activity;
import android.util.Log;
import android.view.Menu;
import android.view.View;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.SimpleAdapter;

public class MainActivity extends Activity {
	private String tag = "SimpleAdapterActivity";
	private String[] names = new String[]
			{
				"觉悟",
				"学习",
				"能力"
			};
	private String[] descs =  new String[]
			{
				"对工作生活的觉悟",
				"对新鲜事物的认知能力",
				"对学习的掌握能力"
			};
	private int[] imageId = new int[]
			{
				R.drawable.consciousness,
				R.drawable.learn,
				R.drawable.ability
			};
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_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", imageId[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","desc"},
				new int[] {R.id.name,R.id.header,R.id.desc}
				);
		ListView list = (ListView) findViewById(R.id.list01);
		//为ListView 设置Adapter
		list.setAdapter(simpleAdapter);
		//为ListView的列表项的点击事件绑定事件监听器
		list.setOnItemClickListener(new OnItemClickListener()
		{

			@Override
			public void onItemClick(AdapterView<?> parent, View view, int position,
					long id) {
				// TODO Auto-generated method stub
				 Log.d(tag, names[position]+"被单击了");  
			}
			
		});			
	}

	@Override
	public boolean onCreateOptionsMenu(Menu menu) {
		// Inflate the menu; this adds items to the action bar if it is present.
		getMenuInflater().inflate(R.menu.main, menu);
		return true;
	}

}

知识点：

SimpleAdapter对象，它需要5个参数

第二个参数：该参数应该是一个List<? extends Map<String,?>>类型的集合对象，该集合中每个Map<String,?>对象生成一个列表项

第三个参数：该参数指定一个界面布局的ID。

第四个参数：该参数应该是一个String[]类型的参数，该参数决定提取Map<String,?>对象中那些key对应的value来生产列表项。

第五个参数：该参数应该是一个int[] 类型的参数，该参数决定填充那些组件

藏上面的代码看，listItems是一个长度为4的集合，这意味着它生产的ListView将会包含4个列表项，每个列表项都是R.layout.simple_item对应的组件。组件内容由listItems集合提供。
调试效果

绑定的单击事件，我们看下日志（刚才我们绑定了列表项单击事件，并单击后输出log）

实现类四：BaseAdapter

扩展BaseAdapter可以取得对Adapter最大的控制权：程序要创建多少个列表项，每个列表项的组件都由开发者来决定。

比较自由

扩展该对象需要重写如下4个方法：

1、getCount()：该方法的返回控制该Adapter将会包含多少个列表项

2、getItem(int position)：该方法的返回值决定第position处的列表项的内容

3、getItemId(int position)：该方法的返回值决定第position处的列表项的ID

4、getView(it position,View convertView,viewGroup parent)：该方法的返回值决定第position处的列表项组件