Android开发 - ListView的使用

2018-05-20 本文已影响0人蒋佳秋

内容同步于我的博客：https://blog.bigrats.net/archives/android-dev-listview.html

在Android开发中，ListView是最常用的组件之一，以列表的形式展现内容，并且可以自定义点击、长按等响应事件。如下图所示。

android-dev-listview-1.png

要显示出一个列表，需要以下两个部分：

ListView：用以显示列表的基本View
Adapter：包含ArrayAdapter，SimpleAdapter和SimpleCursorAdapter三种Adapter，用以将数据映射到ListView中

当然，我们还需要显示的数据，然后才能通过Adapter将其传送到ListView中显示。

1 ListView

在布局文件中添加ListView：

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

这里我将width设置为match_parent，使得item整行可点击，可根据自己需要去修改。

2 Adapter

在三种Adapter中，以ArrayAdapter使用最为简单，SimpleAdapter可定制化程度最高，SimpleCursorAdapter是SimpleAdapter对数据库的整合，使用更加方便。

2.1 ArrayAdapter

ArrayAdapter是三种Adapter中最简单最易实现的一种，构造体函数如下：

ArrayAdapter(Context context, int resource, List<T> objects)

在Activity.java中，加入以下代码实现数据和ListView的绑定：

private ListView listView;
listView = (ListView) findViewById(R.id.id_listView);
listView.setAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_expandable_list_item_1,getData()));

其中，android.R.layout.simple_expandable_list_item_1是系统定义好的只显示一行文字的布局文件，getData()是我假设的获取数据的函数，定义如下：

private List<String> getData(){
    List<String> data = new ArrayList<String>();

    data.add("ListItem 0");
    data.add("ListItem 1");
    data.add("ListItem 2");

    return data;
}

运行后的效果如下图所示：

android-dev-listview-2.png

2.2 SimpleCursorAdapter

使用SimpleCursorAdapter可以简单的将从Cursor获得的数据进行列表显示，这里我们直接调用通讯录数据库。

private ListView listView;

listView = (ListView) findViewById(R.id.id_listView);
Cursor cursor = getContentResolver().query(People.CONTENT_URI, null, null, null, null);
startManagingCursor(cursor);

ListAdapter listAdapter = new SimpleCursorAdapter(this, android.R.layout.simple_expandable_list_item_1, 
            cursor,
            new String[]{People.NAME}, 
            new int[]{android.R.id.text1});
listView.setAdapter(listAdapter);

首先通过getContentResolver().query(People.CONTENT_URI, null, null, null, null)获得一个指向系统通讯录的Cursor来获取数据，然后startManagingCursor(cursor)将获得的Cursor对象交由Activity。android.R.id.text1是将数据映射到的组件的id。最后，为了使用通讯录数据库，我们需要在AndroidManifest.xml中添加权限：

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

运行后如下图所示：

android-dev-listview-3.png

2.3 SimpleAdapter

SimpleAdapter是可定制化程度最高，使用最灵活的Adapter，可以放入ImageView，Button等组件。以下以一个带图片的List为例说明。

我们首先需要定义每一个item的layout。在layout文件夹中新建list_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="match_parent"
    android:padding="10dp">

    <ImageView android:id="@+id/id_image"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:layout_margin="5dp"/>

    <LinearLayout android:orientation="vertical"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content">

        <TextView android:id="@+id/id_title"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:textColor="@color/md_black_1000"
            android:textSize="24dp" />
        <TextView android:id="@+id/id_info"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:textColor="@color/md_black_1000"
            android:textSize="16dp" />

    </LinearLayout>

</LinearLayout>

在Activity.java中，加入以下代码实现数据和ListView的绑定：

this.listView = (ListView) view.findViewById(R.id.id_listView);
SimpleAdapter adapter = new SimpleAdapter(this.getContext(),getData(),R.layout.list_item,
        new String[]{"title","info","image"},
        new int[]{R.id.id_title,R.id.id_info,R.id.id_image});
this.listView.setAdapter(adapter);

SimpleAdapter的数据使用HashMap构成的List，HashMap的每一个键值根据id对应关系映射到布局文件中相应的组件上，如上代码则将title映射到R.id.id_title，info映射到R.id.id_info，image映射到R.id.id_image。getData()演示数据获取函数定义如下：

private List<Map<String, Object>> getData() {
    List<Map<String, Object>> list = new ArrayList<>();
    Map<String, Object> map;
    
    for(int i=0;i<3;i++){
        map = new HashMap<>();
        map.put("title", "Title "+i+" Camera");
        map.put("info", "Info "+i+" CameraInfo");
        map.put("image", R.drawable.ic_menu_camera);
        list.add(map);
    }

    return list;
}