Android--UI之ListView

前言

　　今天讲解一下Android平台下ListView控件的开发，在本篇博客中，将介绍ListView的一些常用属性、方法及事件，还会讲解ListView在开发中常用的几种方式，以及使用不通用的适配器Adapter定制个性的View视图用于ListView的展示。

ListView

　　ListView，列表视图，直接继承了AbsListView，是一个以垂直方式在项目中显示View视图的列表。ListView的数据项，来自一个继承了ListAdapter接口的适配器。

　　ListView的常用属性一般就是用来设置列表的间隔、分割线、表头、表尾等属性的，常用属性有以下几个，并且Android也为其提供了对应的setter/getter方法：

• android:divider：使用一个Drawable或者color设置数据项之间的间隔样式。
• android:dividerHeight：设置数据项之间的间隔距离。
• android:entries：设置一个资源Id用于填充ListView的数据项。
• android:footerDividersEnabled：设定列表表尾是否显示分割线，如果有表尾的话。
• android:headerDividerEnabled：设定列表表头是否显示分割线，如果有表头的话。

　　ListView提供了一些方法，用于操作ListView。这里介绍一些常用的方法，更多的请参见API文档：

• void addFooterView(View v)：添加表尾View视图。
• boolean removeFooterView(View v)：移除一个表尾View视图。
• void addHeaderView(View v)：添加一个表头View视图。
• boolean removeHeaderView(View v)：移除一个表头View视图。
• ListAdapter getAdapter()：获取当前绑定的ListAdapter适配器。
• void setAdapter(ListAdapter adapter)：设置一个ListAdapter适配器到当前ListView中。
• void setSelection(int posotion)：设定当前选中项。
• long[] getCheckItemIds()：获取当前选中项。

　　作为一个列表选择控件，ListView具有一些选中选项可以触发的事件，但它本身没有定义这些事件，均继承自间接父类AdapterView。ListView支持的几个常用事件有以下几个：

• AdapterView.OnItemCLickListener：列表项被点击时触发。
• AdapterView.OnItemLongClickListener：列表项被长按时触发。
• AdapterView.OnItemSelectedListener：列表项被选择时触发。

　　在Android项目中使用ListView，有两种方式，一种是通过一个继承了ListActivity的Activity，在其中设定ListAdapter，对于这种方式，比较适用于整个页面就是一个ListView；第二种方式就是直接使用ListView控件，这种方式也是项目中比较常用的方式。

ListActivity

　　ListActivity继承了Activity，并通过绑定一个ListAdapter来显示一个数据列表。需要注意的是，如果对列表项的数据格式没有特殊要求，它完全可以不使用布局文件即可创建一个ListView，因为ListActivity类本身已经包含了一个ListView。因此在onCreate()方法中，不需要调用setContentView()方法来从一个布局文件加载用户界面。

　　在ListActivity的onCreate()方法中，可以直接使用this.setListAdapter()方法为这个ListView设定ListAdapter。如果想获得并操作这个ListActivity自带的ListView，可以使用this.getListView()方法获取。

　　下面通过一个Demo讲解一下使用继承ListActivity的方式来实现ListView，因为这里只是使用一个ArrayAdapter填充数据，无需指定布局文件，这里只提供实现代码：

package com.bgxt.datatimepickerdemo;

import android.app.ListActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast;

public class ListActivityDemo extends ListActivity {
    private String[] presidents={"北京","深圳","济南","广州","海南","香港","澳门"};
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // TODO Auto-generated method stub
        super.onCreate(savedInstanceState);
        ListView listview=getListView();
        //添加一个TextView作为表头
        TextView tvHeader=new TextView(ListActivityDemo.this);
        tvHeader.setText("城市列表头");
        listview.addHeaderView(tvHeader);
        //添加一个TextView作为表尾
        TextView tvFooter=new TextView(ListActivityDemo.this);
        tvFooter.setText("城市列表尾");
        listview.addFooterView(tvFooter);
        listview.setAdapter(new ArrayAdapter<String>(this,android.R.layout.simple_list_item_1,presidents));
        
    }
    @Override
    protected void onListItemClick(ListView parent, View view, int position, long id) {
        
        Toast.makeText(this, "You have selected "+presidents[position], Toast.LENGTH_SHORT).show();
    }
}

　　效果展示：

使用ListView控件构建

　　上面介绍的这种方式会将整个Activity都作为一个ListView，但是在实际项目中，一般还是把ListView作为一个数据显示控件，填充在布局中。现在通过一个简单的Demo，讲解使用ListView控件展示一个ArrayAdapter填充的数据列表。

　　布局代码：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >
    <!-- 设定列表项的分割线为蓝色，并且数据项之间分割10个dp -->
    <ListView
        android:id="@+id/listviewsimple"
        android:layout_width="match_parent"
        android:layout_height="match_parent" 
        android:divider="#00F"
        android:dividerHeight="10dp"/>
</LinearLayout>

　　实现代码：

package com.bgxt.datatimepickerdemo;

import java.util.ArrayList;
import java.util.List;

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

public class ListViewSimpleActivity extends Activity {
    private ListView listview;
    private ArrayAdapter<String> adapter;
    private List<String> data;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // TODO Auto-generated method stub
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_listviewsimple);
        getData();//填充数据
        listview=(ListView)findViewById(R.id.listviewsimple);
        //设定列表项的选择模式为单选
        adapter=new ArrayAdapter<String>(ListViewSimpleActivity.this, android.R.layout.simple_list_item_single_choice, data);
        listview.setChoiceMode(ListView.CHOICE_MODE_SINGLE);
        listview.setAdapter(adapter);
    }
    
    private void getData(){
        data=new ArrayList<String>();
        data.add("北京");
        data.add("上海");
        data.add("深圳");
        data.add("武汉");
        data.add("宜昌");
        data.add("成都");
        data.add("贵阳");
        data.add("杭州");
        data.add("济南");
        data.add("天津");
    }
}

　　效果展示：

使用SimpleAdapter填充数据

　　ListView的使用范围很广，一般也不仅仅用来展示简单的数据，对于一些复杂样式的数据而言，可以使用SimpleAdapter这个适配器。对于SimpleAdapter适配器的用法，可以参见我的另外一篇博客：Android--UI之Spinner，这里就不再累述了。

　　下面直接通过一个Demo讲解，在这个Demo中，对于SimpleAdapter填充样式而言，不再单独给定模板，直接使用布局的模板。

　　布局代码：

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

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal" >
        <!-- LinnerLayout定义的三个控件，将成为ListView控件的模板 -->
        <ImageView
            android:id="@+id/ivIcon"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="3dp"
            android:maxHeight="5dp"
            android:maxWidth="5dp"
            android:src="@drawable/ic_launcher" />

        <TextView
            android:id="@+id/tvName"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:layout_weight="1"
            android:text="好友名称" />

        <TextView
            android:id="@+id/tvSS"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:layout_weight="4"
            android:text="签名" />
    </LinearLayout>

    <ListView
        android:id="@+id/lvArray"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</LinearLayout>

　　实现代码：

package com.bgxt.datatimepickerdemo;

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

import android.app.Activity;
import android.os.Bundle;
import android.widget.ListView;
import android.widget.SimpleAdapter;

public class SimpleAdapterActivity extends Activity {
    private ListView listview;
    private SimpleAdapter simpleAdapter;
    private List<Map<String, Object>> data;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // TODO Auto-generated method stub
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_listviewarrayadapter);
        listview = (ListView) findViewById(R.id.lvArray);
        //填充数据
        putData();
        //这里使用当前的布局资源作为ListView的模板。
        //使用这种方式，SimpleAdapter会忽略ListView控件，仅以ListView之外的控件作为模板。
        simpleAdapter = new SimpleAdapter(SimpleAdapterActivity.this, data,
                R.layout.activity_listviewarrayadapter, new String[] { "icon",
                        "name", "ss" }, new int[] { R.id.ivIcon, R.id.tvName,
                        R.id.tvSS });
        listview.setAdapter(simpleAdapter);
    }
    
    private void putData()
    {
        data=new ArrayList<Map<String,Object>>();
        Map<String, Object> map1=new HashMap<String, Object>();
        map1.put("icon", R.drawable.item1);
        map1.put("name", "简爱");
        map1.put("ss", "风将绿了夜的途");
        Map<String, Object> map2=new HashMap<String, Object>();
        map2.put("icon", R.drawable.item2);
        map2.put("name", " 陌 陌");
        map2.put("ss", "寻找你,你在我心中__。");
        Map<String, Object> map3=new HashMap<String, Object>();
        map3.put("icon", R.drawable.item3);
        map3.put("name", "汐颜");
        map3.put("ss", "最新分享:中国合伙人正能量22句话...");
        Map<String, Object> map4=new HashMap<String, Object>();
        map4.put("icon", R.drawable.item4);
        map4.put("name", "花仙子");
        map4.put("ss", " ");
        data.add(map1);
        data.add(map2);
        data.add(map3);
        data.add(map4);
    }
}

　　效果展示：

　　源码下载

　　请支持原创，尊重原创，转载请注明出处。谢谢。