Android ListView控件使用方法

概述

Android ListView控件是常用的用来展示数据的控件，它能够以列表的形式展示数据，并且支持滑动查看所有列表项。本文将详细介绍Android ListView控件的使用方法。

步骤

1.创建列表项布局

在Android Studio中创建一个XML布局文件用来定义列表项的样式。例如，我们创建一个名为list_item.xml的文件，该文件定义了列表项的样式：

<?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="wrap_content">

    <ImageView
        android:id="@+id/imageView"
        android:layout_width="50dp"
        android:layout_height="50dp" />

    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="16sp"
        android:padding="10dp"
        android:textColor="@android:color/black" />

</LinearLayout>

2.创建数据源

在代码中创建数据源，可以是一个字符串数组或者一个自定义的数据结构。例如，我们创建一个名为dataList的字符串数组，作为数据源。

private String[] dataList = new String[]{"Apple", "Banana", "Orange", "Watermelon", "Pear", "Grape", "Pineapple", "Strawberry", "Cherry", "Mango"};

3.创建适配器

创建适配器对象，用来绑定数据和列表项布局。使用默认的ArrayAdapter可以快速实现适配器的创建和绑定过程。例如，我们通过以下代码创建适配器：

ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, R.layout.list_item, R.id.textView, dataList);

上述代码中，第一个参数this代表当前Activity实例对象，第二个参数R.layout.list_item代表列表项布局文件，第三个参数R.id.textView代表要展示数据的控件id，第四个参数dataList代表数据源。

4.将适配器设置到ListView中

在代码中找到ListView控件，将适配器对象设置到ListView中：

ListView listView = findViewById(R.id.listView);
listView.setAdapter(adapter);

5.显示列表数据

运行代码，即可看到以列表形式展示数据的ListView控件了。

示例

下面给出两个简单的示例。

示例1：ListView展示图片和文字

为了演示如何在ListView中展示图片和文字，我们重新定义list_item.xml布局文件，并且创建了一个CustomAdapter适配器，通过它绑定数据和列表项布局。

list_item.xml布局文件：

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/list_item"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp">

    <ImageView
        android:id="@+id/image_view"
        android:layout_width="50dp"
        android:layout_height="50dp"
        android:src="@drawable/ic_launcher_background"
        android:contentDescription="图片" />

    <TextView
        android:id="@+id/text_view"
        android:layout_gravity="center_vertical"
        android:layout_marginStart="16dp"
        android:textSize="20sp"
        android:text="文本" />

</LinearLayout>

CustomAdapter适配器：

public class CustomAdapter extends BaseAdapter {

    private List<MyItem> dataList;
    private Context context;

    public CustomAdapter(Context context, List<MyItem> dataList) {
        this.context = context;
        this.dataList = dataList;
    }

    @Override
    public int getCount() {
        return dataList.size();
    }

    @Override
    public Object getItem(int position) {
        return dataList.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

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

        ViewHolder holder;

        if (convertView == null) {
            convertView = LayoutInflater.from(context).inflate(R.layout.list_item, null);
            holder = new ViewHolder();
            holder.imageView = (ImageView) convertView.findViewById(R.id.image_view);
            holder.textView = (TextView) convertView.findViewById(R.id.text_view);
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }

        MyItem item = dataList.get(position);
        holder.imageView.setImageResource(item.getImageResId());
        holder.textView.setText(item.getText());

        return convertView;
    }

    private static class ViewHolder {
        public ImageView imageView;
        public TextView textView;
    }

}

使用CustomAdapter适配器：

List<MyItem> dataList = new ArrayList<MyItem>();
dataList.add(new MyItem(R.drawable.apple, "苹果"));
dataList.add(new MyItem(R.drawable.banana, "香蕉"));
dataList.add(new MyItem(R.drawable.orange, "橙子"));
dataList.add(new MyItem(R.drawable.watermelon, "西瓜"));
dataList.add(new MyItem(R.drawable.pear, "梨"));
dataList.add(new MyItem(R.drawable.grape, "葡萄"));
dataList.add(new MyItem(R.drawable.pineapple, "菠萝"));
dataList.add(new MyItem(R.drawable.strawberry, "草莓"));
dataList.add(new MyItem(R.drawable.cherry, "樱桃"));
dataList.add(new MyItem(R.drawable.mango, "芒果"));

CustomAdapter adapter = new CustomAdapter(this, dataList);
ListView listView = findViewById(R.id.listView);
listView.setAdapter(adapter);

其中，MyItem是自定义的数据结构，用于存储图片和文本信息。

public class MyItem {

    private int imageResId;
    private String text;

    public MyItem(int imageResId, String text) {
        this.imageResId = imageResId;
        this.text = text;
    }

    public int getImageResId() {
        return imageResId;
    }

    public String getText() {
        return text;
    }

}

通过以上示例，我们可以了解如何在ListView中展示带有图片和文字的列表项。

示例2：ListView实现下拉刷新

为了演示如何在ListView中实现下拉刷新，我们添加了SwipeRefreshLayout控件，用来包裹ListView控件，并监听下拉操作，当下拉时触发刷新操作。

布局文件：

<androidx.swiperefreshlayout.widget.SwipeRefreshLayout
    android:id="@+id/refresh_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ListView
        android:id="@+id/list_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:divider="#ccc"
        android:dividerHeight="1dp" />

</androidx.swiperefreshlayout.widget.SwipeRefreshLayout>

在Activity中，我们需要对SwipeRefreshLayout对象设置下拉刷新监听，当触发下拉刷新时，通过updateData()方法更新数据源，接着调用adapter.notifyDataSetChaged()方法，刷新ListView中的数据。为了模拟网络请求，这里使用Handler延迟2秒来更新数据。

SwipeRefreshLayout refreshLayout = findViewById(R.id.refresh_layout);
ListView listView = findViewById(R.id.list_view);

//初始化数据
dataList = getData();
CustomAdapter adapter = new CustomAdapter(this, dataList);
listView.setAdapter(adapter);

//下拉刷新监听器
refreshLayout.setOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
    @Override
    public void onRefresh() {
        updateData();
    }
});

//更新数据源
private void updateData() {
    new Handler().postDelayed(new Runnable() {
        @Override
        public void run() {
            List<MyItem> newDataList = getData();
            dataList.clear();
            dataList.addAll(newDataList);
            adapter.notifyDataSetChanged();
            refreshLayout.setRefreshing(false);
        }
    }, 2000);
}

//下拉刷新数据
private List<MyItem> getData() {
    List<MyItem> dataList = new ArrayList<>();
    for (int i = 0; i < 10; i++) {
        dataList.add(new MyItem(R.drawable.ic_launcher_background, "文本" + i));
    }
    return dataList;
}

通过以上示例，我们可以了解如何在ListView中实现下拉刷新的功能。

总结

通过本文的介绍，我们了解到了ListView控件的使用方法，并通过示例加深了对ListView控件的理解。在实际开发中，ListView控件是一种非常常用的控件，通过学习本文中的知识，相信可以帮助我们更好地使用ListView控件来展示数据。