ListView使用详解

OPhone开发中经常会用到各种各样的组件，像TextView，Button等等。其中经常会使用到ListView（列表），ListView以列表的形式展示具体内容，并且能够根据数据的长度自适应显示。本篇将由浅入深的介绍几种列表，并着重介绍如何自定义列表。具体的表现形式如图1所示。在OPhone系统中，列表的显示需要三个元素：

 

1．ListVeiw 用来展示列表的View。

2．适配器 用来把数据映射到ListView上的中介。

3．数据    具体的将被映射的字符串，图片，或者基本组件。

 

根据列表的适配器类型，列表分为三种，ArrayAdapter，SimpleAdapter和SimpleCursorAdapter

其中以ArrayAdapter最为简单，只能展示一行字，如图1所示。SimpleAdapter有最好的扩充性，可以自定义出各种效果。SimpleCursorAdapter可以认为是SimpleAdapter对数据库的简单结合，可以方面的把数据库的内容以列表的形式展示出来。

 

ArrayAdapter

使用ArrayAdapter显示列表非常简单。代码如下：

 

public class List1 extendsActivity {

    private ListVeiw listView;
    @Override
    public void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);

       listView=new ListVeiw(this);
       listView.setAdapter(new ArrayAdapter<String>(this,
           android.R.layout.simple_list_item_1, mStrings));
      setContentVieww(listView);
        }

   private String[] mStrings = {
           "Abbaye de Belloc", "Abbaye du Mont des Cats",
           "Acorn", "Adelost", "Affidelice au Chablis",
           "Aisy Cendre", "Allgauer Emmentaler", "Alverca",
           "Ami du Chambertin", "Anejo Enchilado", "Anneau
           "Aragon", "Ardi Gasna", "Ardrahan", "Armenian
           "Asadero", "Asiago", "Aubisque Pyrenees", "Autun",
            "Babybel", "Baguette Laonnaise", "Bakers", "Bal"};
}

public class List1 extendsActivity { private ListVeiw listView; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); listView=new ListVeiw(this); listView.setAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, mStrings)); setContentVieww(listView); } private String[] mStrings = { "Abbaye de Belloc", "Abbaye du Mont des Cats", "Acorn", "Adelost", "Affidelice au Chablis", "Aisy Cendre", "Allgauer Emmentaler", "Alverca", "Ami du Chambertin", "Anejo Enchilado", "Anneau "Aragon", "Ardi Gasna", "Ardrahan", "Armenian "Asadero", "Asiago", "Aubisque Pyrenees", "Autun", "Babybel", "Baguette Laonnaise", "Bakers", "Bal"}; }

 

 

上面代码首先定义一个ListView类型的View对象，用来显示视图。其次使用ArrayAdapter（数组适配器）顾名思义，需要把数据放入一个数组以便显示。ListView如何显示数组中的数据呢？这就需要一个连接ListView视图对象和数组数据的适配器来两者的适配工作。数组适配器的构造需要三个参数，依次为this,布局文件（注意这里的布局文件描述的是列表的每一行的布局，android.R.layout.simple_list_item_1是系统定义好的布局文件只显示一行文字，有许多这样的文件，可以在OPhone目录的OPhoneSDK_1.5\platforms\android-1.5\data\res\layout下面查看），数组。同时用setAdapter（）完成适配的最后工作。此段代码的显示效果如图1所示。

 

 

 

             图1 数组适配器显示的列表

 

SimpleCursorAdapter

 

SimpleCursorAdapter使用起来也是非常简单。下面以读取通讯录数据库为例加以介绍。首先为了保证列表的显示，你应该至少在通讯录中添加一个联系人作为数据库的数据。然后获得一个指向数据库的Cursor并且定义一个布局文件（当然也可以使用系统自带的）。

代码如下：

 

 

public class List2 extends Activity {

    private ListView listView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        listView=new ListView(this);
       Cursorc=getContentResolver().query(People.CONTENT_URI,
       null, null, null, null);
        startManagingCursor(c);

        ListAdapter adapter = new SimpleCursorAdapter(this,
                 android.R.layout.simple_list_item_1,
                 c,
                 new String[] {People.NAME} ,
                 new int[] {android.R.id.text1});
        listView.setAdapter(adapter);
setContentView(listView);
}
}

public class List2 extends Activity { private ListView listView; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); listView=new ListView(this); Cursorc=getContentResolver().query(People.CONTENT_URI, null, null, null, null); startManagingCursor(c); ListAdapter adapter = new SimpleCursorAdapter(this, android.R.layout.simple_list_item_1, c, new String[] {People.NAME} , new int[] {android.R.id.text1}); listView.setAdapter(adapter); setContentView(listView); } }

 

 

在上面的ArrayAdapter里面也许读者并没有理解映射的概念，因为是系统自己做了映射。这段程序将告诉你什么是映射。首先定义用来显示的ListView对象，然后获得一个指向系统通讯录数据库的Cursor对象获得数据来源。我们将获得的Cursor对象交由Activity管理，这样Cursor的生命周期和Activity便能够自动同步，省去自己手动管理Cursor。或者使用managerQuery（）方法代替query。）也可以得到同样的效果。下面要做的是将数据库数据映射到ListView实例上。需要定义SimpleCursorAdapter，他的五个参数依次为this，布局文件，Cursor实例，一个包含数据库的列的String型数组，一个包含布局文件中对应组件id的int型数组。SimpleCursorAdapter做的工作就是自动的将String型数组所表示的每一列数据映射到布局文件对应id的组件上。上面的代码，将NAME列的数据一次映射到布局文件的id为text1的组件上。

 

效果如图2 所示：

 

 

 

       图2 使用SimpleCursorAdapter显示的列表

 

上面的Ntopo，Liuzhoyun，Kun，Android，Nexus One是我添加的联系人名字。

 

SimpleAdapter

 

有图片的ListView

 

SimpleAdapter放在最后，因为它太有意思了。你能定义各种各样的布局出来，可以放上ImageView（图片），还可以放上Button（按钮），CheckBox（复选框）等等。在此有必要说一下ListActivity。ListActivity和普通的Activity没有太大的差别，不同就是对显示ListView做了许多优化，方面显示而已。

 

下面的例子将显示一张图片和两行文字,效果如下图3示：

 

 

 

       图 3 有图片的ListView

 

 

首先定义一个布局文件，item.xml内容如下：

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

 <ImageView android:id="@+id/img"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 />
 <LinearLayout android:orientation="vertical"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 >
 <TextView android:id="@+id/BigText"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 android:textColor="#FFFFFFFF"
 android:textSize="30px"
 />
 <TextView android:id="@+id/LittleText"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 android:textColor="#FFFFFFFF"
 android:textSize="15px"
 />
 </LinearLayout>


</LinearLayout>

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="wrap_content" android:layout_height="wrap_content" android:orientation="horizontal"> <ImageView android:id="@+id/img" android:layout_width="wrap_content" android:layout_height="wrap_content" /> <LinearLayout android:orientation="vertical" android:layout_width="wrap_content" android:layout_height="wrap_content" > <TextView android:id="@+id/BigText" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textColor="#FFFFFFFF" android:textSize="30px" /> <TextView android:id="@+id/LittleText" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textColor="#FFFFFFFF" android:textSize="15px" /> </LinearLayout> </LinearLayout>

 

 

然后JavaCode如下：

public class List3 extends ListActivity {

    List<Map<String, Object>> list;

    @Override
    public void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);

       list = getListForSimpleAdapter();

       SimpleAdapter     adapter = new SimpleAdapter(this, list,
R.layout.item,
       new String[] { "BigText", "LittleText", "img" },
new int[] { R.id.BigText,R.id.LittleText, R.id.img });

       setListAdapter(adapter);


    }

    private List<Map<String, Object>> getListForSimpleAdapter() {
    List<Map<String,Object>> list=newArrayList<Map<String,        Object>>(3);
           Map<String, Object> map = new HashMap<String, Object>();
           map.put("BigText", "Android");
           map.put("LittleText", "Google phone.");
           map.put("img", R.drawable.n);
           list.add(map);

           map = new HashMap<String, Object>();
           map.put("BigText", "Lenovo");
           map.put("LittleText", "Ophone");
           map.put("img", R.drawable.o);
           list.add(map);

           map = new HashMap<String, Object>();
           map.put("BigText", "Droid");
           map.put("LittleText", "Motorola");
           map.put("img", R.drawable.droid);
           list.add(map);


       return list;
    }


}

public class List3 extends ListActivity { List<Map<String, Object>> list; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); list = getListForSimpleAdapter(); SimpleAdapter adapter = new SimpleAdapter(this, list, R.layout.item, new String[] { "BigText", "LittleText", "img" }, new int[] { R.id.BigText,R.id.LittleText, R.id.img }); setListAdapter(adapter); } private List<Map<String, Object>> getListForSimpleAdapter() { List<Map<String,Object>> list=newArrayList<Map<String, Object>>(3); Map<String, Object> map = new HashMap<String, Object>(); map.put("BigText", "Android"); map.put("LittleText", "Google phone."); map.put("img", R.drawable.n); list.add(map); map = new HashMap<String, Object>(); map.put("BigText", "Lenovo"); map.put("LittleText", "Ophone"); map.put("img", R.drawable.o); list.add(map); map = new HashMap<String, Object>(); map.put("BigText", "Droid"); map.put("LittleText", "Motorola"); map.put("img", R.drawable.droid); list.add(map); return list; } }

 

 

用SimpleAdapter做适配，数据来源不是一个数据库的Cursor实例，不是数组，往往是用一个有HashMap构成的List，我们在list中插入HashMap类型数据，作为数据来源。list的每一节对应ListView的每一行。HashMap的每个键值数据映射到布局文件中对应id的组件上。有图片的ListView首先准备些图片和数据，这个工作在getListForSimpleAdapter（）中完成了。因为系统没有对应的布局文件可用，我们可以自己定义一个布局item.xml。下面做适配，new一个SimpleAdapter参数一次是：this，布局文件（item.xml），HashMap的BigText和LittleText，img。布局文件的组件id，BigText，LittleText，img。布局文件的各组件分别映射到HashMap的各元素上，完成适配。

 

 

有按钮的ListView

 

但是有时候，列表不光会用来做显示用，我们同样可以在在上面添加按钮。添加按钮首先要写一个有按钮的xml文件，然后自然会想到用上面的方法定义一个适配器，然后将数据映射到布局文件上。但是事实并非这样，因为按钮是无法映射的，即使你成功的用布局文件显示出了按钮也无法添加按钮的响应，这时就要研究一下ListView是如何现实的了，而且必须要重写一个类继承BaseAdapter。下面的示例将显示一个按钮和一个图片，两行字如果单击按钮将删除此按钮的所在行。并告诉你ListView究竟是如何工作的。效果如下：

 

 

              图 4   有按钮的ListView

 

布局文件是在上面的item.xml里添加一个按钮：

 

 

<Button android:id="@+id/bt"
 android:layout_height="wrap_content"
 android:layout_width="wrap_content"
 android:text="Details"
 android:layout_gravity="bottom|right"
 />

<Button android:id="@+id/bt" android:layout_height="wrap_content" android:layout_width="wrap_content" android:text="Details" android:layout_gravity="bottom|right" />

 

JavaCode如下：

 

public class List3 extends ListActivity {

    private String []phone={"Android","Lenovo","Droid"};
    private String []maker={"Google phone","Ophone","Motorola"};
    private    int[]imgid={R.drawable.n,R.drawable.o,R.drawable.droid};

    @Override
    public void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);

       MyAdapter adapter = new MyAdapter(this);
       setListAdapter(adapter);

    }

    public void sdelete(){

        new AlertDialog.Builder(this)
        .setTitle("自定义ListVeiw")
        .setMessage("oh，you clicked the button")
        .setPositiveButton("确定",
         new DialogInterface.OnClickListener()
        {
          publicvoid onClick(DialogInterface dialog, intwhButton)
{
}
})
        .show();
    }

    public final class ViewHolder{
        public TextView BigText;
        public TextView LittleText;
        public ImageView img;
        public Button sdelete;
    }

    public class MyAdapter extends BaseAdapter
    {
        private LayoutInflater inflater;
        private Context mcontext=null;//assume 2 data

        public MyAdapter(Context context){

               this.mcontext=context;
               inflater=LayoutInflater.from(mcontext);

       }
       public int getCount() {
           return phone.length;
       }

       public Object getItem(int arg0) {
           return null;
       }

       public long getItemId(int arg0) {
           return 0;
       }

       public View getView(int position, View convertView,
       ViewGroup parent) {

           ViewHolder holder;
           if(convertView==null){

              convertView =inflater.inflate(R.layout.item,null);
              holder=new ViewHolder();
              holder.BigText=(TextView)convertView.findViewById(R.id.BigText
）;
holder.LittleText=(TextView)convertView.findViewById(R.id.LittleText);
    holder.img=(ImageView)convertView.findViewById(R.id.img);
    holder.sdelete=(Button)convertView.findViewById(R.id.bt);


              holder.BigText.setText(phone[position]);
              holder.LittleText.setText(maker[position]);
              holder.img.setBackgroundResource(imgid[position]);

              convertView.setTag(holder);

holder.sdelete.setOnClickListener(new Button.OnCli ckListener(){
              public void onClick(View arg0) {
                     // TODO Auto-generated method stub
                     sdelete();
                  }
           });


           }else{

              holder=(ViewHolder)convertView.getTag();

              holder.BigText.setText(phone[position]);
              holder.LittleText.setText(maker[position]);
              holder.img.setBackgroundResource(imgid[position]);

              holder.sdelete.setOnClickListener(new
                Button.OnClickListener(){
              public void onClick(View v) {
                     // TODO Auto-generated method stub
                sdelete();
                  }

              });
           }

           return convertView;

       }
     }
 }

public class List3 extends ListActivity { private String []phone={"Android","Lenovo","Droid"}; private String []maker={"Google phone","Ophone","Motorola"}; private int[]imgid={R.drawable.n,R.drawable.o,R.drawable.droid}; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); MyAdapter adapter = new MyAdapter(this); setListAdapter(adapter); } public void sdelete(){ new AlertDialog.Builder(this) .setTitle("自定义ListVeiw") .setMessage("oh，you clicked the button") .setPositiveButton("确定", new DialogInterface.OnClickListener() { publicvoid onClick(DialogInterface dialog, intwhButton) { } }) .show(); } public final class ViewHolder{ public TextView BigText; public TextView LittleText; public ImageView img; public Button sdelete; } public class MyAdapter extends BaseAdapter { private LayoutInflater inflater; private Context mcontext=null;//assume 2 data public MyAdapter(Context context){ this.mcontext=context; inflater=LayoutInflater.from(mcontext); } public int getCount() { return phone.length; } public Object getItem(int arg0) { return null; } public long getItemId(int arg0) { return 0; } public View getView(int position, View convertView, ViewGroup parent) { ViewHolder holder; if(convertView==null){ convertView =inflater.inflate(R.layout.item,null); holder=new ViewHolder(); holder.BigText=(TextView)convertView.findViewById(R.id.BigText ）; holder.LittleText=(TextView)convertView.findViewById(R.id.LittleText); holder.img=(ImageView)convertView.findViewById(R.id.img); holder.sdelete=(Button)convertView.findViewById(R.id.bt); holder.BigText.setText(phone[position]); holder.LittleText.setText(maker[position]); holder.img.setBackgroundResource(imgid[position]); convertView.setTag(holder); holder.sdelete.setOnClickListener(new Button.OnCli ckListener(){ public void onClick(View arg0) { // TODO Auto-generated method stub sdelete(); } }); }else{ holder=(ViewHolder)convertView.getTag(); holder.BigText.setText(phone[position]); holder.LittleText.setText(maker[position]); holder.img.setBackgroundResource(imgid[position]); holder.sdelete.setOnClickListener(new Button.OnClickListener(){ public void onClick(View v) { // TODO Auto-generated method stub sdelete(); } }); } return convertView; } } }

 

下面将对上述代码，做详细的解释，listView在开始绘制的时候，系统首先调用getCount（）函数，根据他的返回值得到listView的长度（这也是为什么在开始的第一张图特别的标出列表长度），然后根据这个长度，调用getView（）逐一绘制每一行。如果你的getCount（）返回值是0的话，列表将不显示同样return 1，就只显示一行。

 

 

             图 5 返回不同长度显示列表也不同

 

 

 

系统显示列表时，首先实例化一个适配器（这里将实例化自定义的适配器）。当手动完成适配时，必须手动映射数据，这需要重写getView（）方法。系统在绘制列表的每一行的时候将调用此方法。getView()有三个参数，position表示将显示的是第几行，covertView是从布局文件中inflate来的布局。我们用LayoutInflater的方法将定义好的item.xml文件提取成View实例用来显示。然后将xml文件中的各个组件实例化（简单的findViewById()方法）。这样便可以将数据对应到各个组件上了。但是按钮为了响应点击事件，需要为它添加点击监听器，这样就能捕获点击事件。至此一个自定义的listView就完成了，现在让我们回过头从新审视这个过程。系统要绘制ListView了，他首先获得要绘制的这个列表的长度，然后开始绘制第一行，怎么绘制呢？调用getView()函数。在这个函数里面首先获得一个View（实际上是一个ViewGroup），然后再实例并设置各个组件，显示之。好了，绘制完这一行了。那再绘制下一行，直到绘完为止。在实际的运行过程中会发现listView的每一行没有焦点了，这是因为Button抢夺了listView的焦点，只要布局文件中将Button设置为没有焦点就OK了。