Android开发教程13：UI之列表:ListView

转自： http://liuzhichao.com/p/365.html

ListView是Android开发中比较常用的一个组件，它以列表的形式展示具体内容，并且能够根据数据的长度自适应显示。比如说我们手机里的通讯录就使用到了ListView显示联系人信息。ListView同时也是所有Android UI控件中最为麻烦的控件，之所以麻烦就是因为它的各种的适配器特别麻烦。

创建ListView有两种方式：

1、直接创建ListView

2、让Activity继承ListActivity

列表的显示需要三个元素：
1．ListVeiw ：用来展示列表的View。
2．适配器 ：用来把数据映射到ListView上的中介。
3．数据集   ：具体的将被映射的字符串，图片，或者基本组件。

根据列表的适配器类型，列表分为四种，ArrayAdapter、SimpleAdapter、SimpleCursorAdapter 以及自定义Adapter。
其中以ArrayAdapter最为简单，只能展示一行字。SimpleAdapter有最好的扩充性，可以自定义出各种效果。 SimpleCursorAdapter可以认为是SimpleAdapter对数据库的简单结合，可以方面的把数据库的内容以列表的形式展示出来。

下面我们就通过几个简单的例子讲解一下通过各种适配器来构建ListView。

1、1使用ArrayAdatpter构建ListView

新建一个Android项目:ListViewDemo,同时新建一个类ListViewDemoActivity继承Activity,代码如下：

package com.liuzhichao.listview;import android.app.Activity;import android.os.Bundle;import android.widget.ArrayAdapter;import android.widget.ListView;public class ListViewDemoActivity extends Activity {//定义一个ListViewprivate ListView mListView;//定义一个String数组，数组里的数据就是ListView里的一项    private String[] items={"1、ArrayAdapter_List","2、SimpleAdapter_List"    ,"3、SimpleCursorAdapter_List","4、MyAdapter_List"};    @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        //new一个ListView        mListView = new ListView(this);        //通过setAdapter构建一个ArrayAdapter将items与mListView"绑定"        mListView.setAdapter(new ArrayAdapter<String>(this,        android.R.layout.simple_list_item_1, items));        //显示mListView        setContentView(mListView);    }}

上面代码使用了ArrayAdapter(Context context, int textViewResourceId, List<T> objects)来装配数据，要装配这些数据就需要一个连接ListView视图对象和数组数据的适配器来两者的适配工作，ArrayAdapter的构造需要三个参数，依次为this,布局文件（注意这里的布局文件描述的是列表的每一行的布局，android.R.layout.simple_list_item_1是系统定义好的布局文件只显示一行文字，数据源(一个List集合)。同时用setAdapter（）完成适配的最后工作。运行后的现实结构如下图：

 

1、2使用SimpleAdapter构建ListView

使用simpleAdapter的数据用一般都是HashMap构成的List，list的每一节对应ListView的每一行。HashMap的每个键值数据映射到布局文件中对应id的组件上。下面我们使用SimpleAdapter模拟一个通讯录。

因为系统没有对应的布局文件可用，我们可以自己定义一个布局info.xml：

<?xml version="1.0" encoding="utf-8"?><RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="fill_parent"    android:layout_height="fill_parent" >    <ImageView        android:id="@+id/info_img"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_marginLeft="3dp"        android:src="@drawable/ic_launcher"/>    <TextView        android:id="@+id/info_name"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_toRightOf="@id/info_img"        android:layout_marginTop="5dp"/>    <TextView        android:id="@+id/info_phone"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_below="@id/info_name"        android:layout_toRightOf="@id/info_img"        android:layout_alignBaseline="@id/info_img"/>     <TextView        android:id="@+id/info_region"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_toRightOf="@id/info_phone"        android:layout_alignBaseline="@id/info_phone"        android:layout_marginLeft="10dip"/></RelativeLayout>

新建一个SimpleAdapterListView继续Activity，代码如下：

package com.liuzhichao.listview;import java.util.ArrayList;import java.util.HashMap;import java.util.Map;import android.app.Activity;import android.os.Bundle;import android.widget.ListView;import android.widget.SimpleAdapter;public class SimpleAdapterListView extends Activity{//分别定义通讯录中的用户名、电话、地区等信息private String[] info_Names={"史珍香","赖月京","秦寿生","刘产","扬伟","范剑"};private String[] info_Phones={"13844445144","13844444444","13444445144","13544445144","13644445144","13744445144"};private String[] info_Regions={"火星","水星","木星","月球","美国","未知地区"};//定义一个ArrayList数组，每一条数据对应通讯录中的一个联系人信息private ArrayList<Map<String,Object>> mInfos= new ArrayList<Map<String,Object>>();//定义一个ListViewprivate ListView mListView;@Overrideprotected void onCreate(Bundle savedInstanceState) {// TODO Auto-generated method stubsuper.onCreate(savedInstanceState);//new一个ListViewmListView = new ListView(this);//添加联系人信息for(int i=0;i<info_Names.length;i++){ Map<String,Object> item = new HashMap<String,Object>(); item.put("img", R.drawable.contact_img); item.put("name", info_Names[i]); item.put("phone", info_Phones[i]); item.put("region", info_Regions[i]); mInfos.add(item);}//定义一个SimpleAdapterSimpleAdapter adapter = new SimpleAdapter(this, mInfos, R.layout.info,new String[]{"img","name","phone","region"},new int[]{R.id.info_img,R.id.info_name,R.id.info_phone,R.id.info_region});//设置mListView的适配器为adaptermListView.setAdapter(adapter);setContentView(mListView);}}

 

使用simpleAdapter的数据用一般都是HashMap构成的List，list的每一节对应ListView的每一行。HashMap的每个键 值数据映射到布局文件中对应id的组件上。因为系统没有对应的布局文件可用，我们可以自己定义一个布局info.xml。运行效果如下图：

我相信肯定有人对new SimpleAdapter()中的参数有一些疑问，下面我们就来看一下SimpleAdapter的构造函数：SimpleAdapter(Context context, List <? extends Map <String, ?>> data, intresource, String[] from, int[] to) ，context相信不用解释了，假设将SimpleAdapter用于ListView。那么ListView的每一个列表项就是resource参数值指定的布局。而data参数就是要加载到ListView中的数据。那么from和to呢？在加载列表项时，需要通过组件的id和data参数中List元素中的Map对象对应。因此，from参数为Map对象的key，而to表示组件的id，例如，本例中的参数值为from=new String[]{“img”,”name”,”phone”,”region”}，to=new int[]{R.id.info_img,R.id.info_name,R.id.info_phone,R.id.info_region}),意思就是将Map对象中key为”img”的value绑定到R.id.info_img,将Map对象中key为”name”的value绑定到R.id.info_name，phone、region也类似。所以from和to中的参数是一一对应的关系。同时 from又是对应的Map中的key,to又是对应布局文件中相应组件的ID。

 

1、3使用SimpleCursorAdapter 构建ListView

相比SimpleAdapter，SimpleCursorAdapter 就是方便把从游标得到的数据进行列表显示，并可以把指定的列映射到对应的组件中。SimpleCursorAdapter的构造函数与SimpleAdapter的区别就是多了一个Cursor c：SimpleCursorAdapter(Context context, int layout, Cursor c, String[] from, int[] to)，Cursor就是游标，如果你不清楚游标的概念，就想像成数据查询后的一个结果集。下面是一个通过SimpleCursorAdapter 使用ListView显示系统通讯录中联系人的例子。

package com.liuzhichao.listview;import android.app.Activity;import android.database.Cursor;import android.os.Bundle;import android.provider.ContactsContract.Contacts;import android.widget.ListView;import android.widget.SimpleCursorAdapter;public class SimpleCursorAdapterActivity extends Activity {private ListView mListView;@Overrideprotected void onCreate(Bundle savedInstanceState) {// TODO Auto-generated method stubsuper.onCreate(savedInstanceState);mListView = new ListView(this); Cursor cursor=this.getContentResolver().query(Contacts.CONTENT_URI, null, null, null, null);       SimpleCursorAdapter adapter=new SimpleCursorAdapter(this, android.R.layout.simple_expandable_list_item_2, cursor,                   new String[]{Contacts.DISPLAY_NAME},                new int[]{android.R.id.text1});  mListView.setAdapter(adapter);setContentView(mListView);}}

 

 

 

 

注意：在读取系统通讯录时，需要如下权限：

<uses-permission android:name="android.permission.READ_CONTACTS"/>

左图上是系统通讯录中的联系人，右图是运行的结果。

 

1、4使用自定义Adapter构建ListView

当我们使用系统自带的ArrayAdapter、SimpleAdapter和SimpleCursorAdapter适配器时，对于事件的响应只能局限在一个行单位。假设一行里面有一个按钮和一个图片控件，它们之间的响应操作是不一样的。若采用系统自带的适配器，就不能精确到每个控件的响应事件。这时，我们一般采取自定义适配器来实现这个比较精确地请求。我们再新建一个MyAdapterListActivity继承Activity，使用自定义适配器来实现SimpleAdapterListView中的效果，并新增一个多选框和按钮。效果如下：

MyAdapterListActivity.java:

package com.liuzhichao.listview;import java.util.ArrayList;import java.util.HashMap;import java.util.List;import java.util.Map;import android.app.Activity;import android.app.AlertDialog;import android.content.Context;import android.os.Bundle;import android.view.LayoutInflater;import android.view.View;import android.view.ViewGroup;import android.widget.BaseAdapter;import android.widget.Button;import android.widget.CheckBox;import android.widget.CompoundButton;import android.widget.ImageView;import android.widget.ListView;import android.widget.TextView;public class MyAdapterListActivity extends Activity {//分别定义通讯录中的用户名、电话、地区等信息private String[] info_Names={"史珍香","赖月京","秦寿生","刘产","扬伟","范剑"};private String[] info_Phones={"13844445144","13844444444","13444445144","13544445144","13644445144","13744445144"};private String[] info_Regions={"火星","水星","木星","月球","美国","未知"};//定义一个ArrayList数组，每一条数据对应通讯录中的一个联系人信息private ArrayList<Map<String,Object>> mInfos= new ArrayList<Map<String,Object>>();//定义一个ListViewprivate ListView mListView;@Overrideprotected void onCreate(Bundle savedInstanceState) {// TODO Auto-generated method stubsuper.onCreate(savedInstanceState);//new一个ListViewmListView = new ListView(this);//添加联系人信息for(int i=0;i<info_Names.length;i++){ Map<String,Object> item = new HashMap<String,Object>(); item.put("img", R.drawable.contact_img); item.put("name", info_Names[i]); item.put("phone", info_Phones[i]); item.put("region", info_Regions[i]); mInfos.add(item);}MyAdapter adapter = new MyAdapter(this, mInfos);mListView.setAdapter(adapter);setContentView(mListView);}private class MyAdapter extends BaseAdapter {private Context context;                        //运行上下文       private List<Map<String, Object>> listItems;    //联系人信息集合       private LayoutInflater listContainer;           //视图容器       private boolean[] hasChecked;                   //记录联系人选中状态       public final class ListItemView{                //自定义控件集合                 public ImageView img;                 public TextView name;                 public TextView phone;            public TextView region;            public CheckBox check;               public Button detail;               }         public MyAdapter(Context context, List<Map<String, Object>> listItems) {           this.context = context;                    listContainer = LayoutInflater.from(context);   //创建视图容器并设置上下文           this.listItems = listItems;           hasChecked = new boolean[getCount()];       }   public int getCount() {return listItems.size();}public Object getItem(int position) {return null;}public long getItemId(int position) {return 0;}public View getView(int position, View convertView, ViewGroup parent) {final int selectID = position;ListItemView  listItemView = null;           if (convertView == null) {               listItemView = new ListItemView();                //获取list_item布局文件的视图               convertView = listContainer.inflate(R.layout.myinfo, null);               //获取控件对象               listItemView.img = (ImageView)convertView.findViewById(R.id.info_img);               listItemView.name = (TextView)convertView.findViewById(R.id.info_name);               listItemView.phone = (TextView)convertView.findViewById(R.id.info_phone);             listItemView.region = (TextView)convertView.findViewById(R.id.info_region);            listItemView.detail= (Button)convertView.findViewById(R.id.btn);               listItemView.check = (CheckBox)convertView.findViewById(R.id.checkBox);               //设置控件集到convertView               convertView.setTag(listItemView);            //设置联系人信息            listItemView.img.setBackgroundResource((Integer) listItems.get(                       position).get("img"));              listItemView.name.setText((String) listItems.get(                       position).get("name"));             listItemView.phone.setText((String) listItems.get(                       position).get("phone"));             listItemView.region.setText((String) listItems.get(                       position).get("region"));             //More按钮事件            listItemView.detail.setOnClickListener(new View.OnClickListener() {public void onClick(View v) {showDetailInfo(selectID);}});         // 注册多选框状态事件处理               listItemView.check                       .setOnCheckedChangeListener(new CheckBox.OnCheckedChangeListener() {                           public void onCheckedChanged(CompoundButton buttonView,                                   boolean isChecked) {                               //记录联系人选中状态                               checkedChange(selectID);                           }               });           }else {               listItemView = (ListItemView)convertView.getTag();           } return convertView;}/**       * 记录勾选了哪个联系人      * @param checkedID 选中的联系人序号       */ private void checkedChange(int checkedID) {           hasChecked[checkedID] = !hasChecked(checkedID);       }/**       * 判断联系人是否选择       * @param checkedID 联系人序号       * @return 返回是否选中状态       */  public boolean hasChecked(int checkedID) {           return hasChecked[checkedID];       } /**       * 显示物品详情       * @param clickID       */      private void showDetailInfo(int clickID) {           new AlertDialog.Builder(context)        .setIcon(Integer.parseInt(listItems.get(clickID).get("img").toString()))        .setTitle(listItems.get(clickID).get("name")+"详细信息")           .setMessage("电话:"+listItems.get(clickID).get("phone").toString()+" 地区："+listItems.get(clickID).get("region").toString())                         .setPositiveButton("确定", null)           .show();       } }}

 

myinfo.xml:

<?xml version="1.0" encoding="utf-8"?><RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="fill_parent"    android:layout_height="fill_parent" >    <ImageView        android:id="@+id/info_img"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_marginLeft="3dp"/>    <TextView        android:id="@+id/info_name"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_toRightOf="@id/info_img"        android:layout_marginTop="5dp"/>    <TextView        android:id="@+id/info_phone"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_below="@id/info_name"        android:layout_toRightOf="@id/info_img"        android:layout_alignBaseline="@id/info_img"/>     <TextView        android:id="@+id/info_region"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_toRightOf="@id/info_phone"        android:layout_alignBaseline="@id/info_phone"        android:layout_marginLeft="10dip"/>     <CheckBox         android:id="@+id/checkBox"         android:layout_width="wrap_content"         android:layout_height="wrap_content"         android:layout_marginLeft="5dp"         android:layout_alignBaseline="@id/info_img"         android:layout_toRightOf="@id/info_region"/>     <Button         android:id="@+id/btn"         android:layout_width="wrap_content"         android:layout_height="wrap_content"         android:layout_alignBaseline="@id/checkBox"         android:layout_toRightOf="@id/checkBox"         android:text="More..."         /></RelativeLayout>

2、让Activity继承ListActivity构建ListView

如果程序的窗口仅仅需要显示一个列表，则可以让Activity直接继续ListActivity来实现。ListActivity的子类无需调用setContentView()方法来显示某个界面，而是可以直接传入一个Adapter，ListActivity的子类就可以呈现出一个列表。

package com.liuzhichao.listview;import java.util.ArrayList;import java.util.HashMap;import java.util.Map;import android.app.ListActivity;import android.os.Bundle;import android.widget.SimpleAdapter;public class ListActivityList extends ListActivity {//分别定义通讯录中的用户名、电话、地区等信息private String[] info_Names={"史珍香","赖月京","秦寿生","刘产","扬伟","范剑"};private String[] info_Phones={"13844445144","13844444444","13444445144","13544445144","13644445144","13744445144"};private String[] info_Regions={"火星","水星","木星","月球","美国","未知地区"};//定义一个ArrayList数组，每一条数据对应通讯录中的一个联系人信息private ArrayList<Map<String,Object>> mInfos= new ArrayList<Map<String,Object>>();@Overrideprotected void onCreate(Bundle savedInstanceState) {// TODO Auto-generated method stubsuper.onCreate(savedInstanceState);//添加联系人信息for(int i=0;i<info_Names.length;i++){ Map<String,Object> item = new HashMap<String,Object>(); item.put("img", R.drawable.contact_img); item.put("name", info_Names[i]); item.put("phone", info_Phones[i]); item.put("region", info_Regions[i]); mInfos.add(item);}//定义一个SimpleAdapterSimpleAdapter adapter = new SimpleAdapter(this, mInfos, R.layout.info,new String[]{"img","name","phone","region"}, new int[]{R.id.info_img,R.id.info_name,R.id.info_phone,R.id.info_region});//本例中没有声明一个ListView，但通过继承ListActivity使用setListAdapter然后传入一个适配器即可直接显示一个列表。setListAdapter(adapter);}}