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

[html] view
plaincopy

<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

[html] view
plaincopy

<?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


[html] view
plaincopy

<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

[html] view
plaincopy

<?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

[html] view
plaincopy

<?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

[java] view
plaincopy

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

[java] view
plaincopy

package com.example.android_listview;



import android.app.ListActivity;

import android.os.Bundle;

import android.widget.ArrayAdapter;



/**

* @author LiuxinMing 1235355@qq.com

*/

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

[html] view
plaincopy

<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

[html] view
plaincopy

<?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代码

[java] view
plaincopy

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处的列表项组件