安卓常用控件--列表视图

（一）列表视图概述

1、继承关系图

• 列表视图（ListView）继承了抽象列表视图（AbsListView），而抽象列表视图又继承了适配器视图（AdapterView）。适配器视图具有共同的特征，就是利用适配器将数据源与展示控件绑定起来。
• 

2、列表视图API文档

• https://developer.android.google.cn/reference/kotlin/android/widget/ListView?hl=en
  

3、 列表视图四要素

要素	说明
列表控件	显示多项供用户选择
适配器	数组适配器、简单适配器、游标适配器、基适配器……
数据源	数组、列表、游标……
列表项模板	平台资源、用户自定义

• 列表视图四要素：列表控件、适配器、列表项模板和数据源
  

4、四种适配器

• 列表视图（ListView），它是AdapterView的孙子类，要通过适配器作为梁桥来绑定数据源

适配器	含义
ArrayAdapter	数组适配器
SimpleAdapter	简单适配器
SimpleCursorAdapter	简单游标适配器
BaseAdapter	基适配器

（二）数组适配器

1、数组适配器API文档

https://developer.android.google.cn/reference/android/widget/ArrayAdapter?hl=en

2、数组适配器继承关系

• ArrayAdapter类继承了BaseAdapter类
  

3、数组适配器构造方法

• 数组适配器提供了6个重载的构造方法（下面的案例中我们会学习第5种构造方法来创建数组适配器）
  
• 第五个构造方法参数说明
  

（三） 基于数组适配器使用列表视图案例 —— 阅读古诗

1、创建安卓应用

• 基于Empty Activity创建安卓应用 - ReadAnicientPoetry
  
• 单击【finish】按钮
  

2、准备图片素材

• 将背景图片拷贝到Drawable目录里
  

3、字符串资源文件

• 字符串资源文件strings.xml
  

<resources>
    <string name="app_name">阅读古诗</string>

    <string-array name="titles">
        <item>静夜思</item>
        <item>登鹳雀楼</item>
        <item>相思</item>
        <item>听弹琴</item>
        <item>登乐游原</item>
        <item>朝发白帝城</item>
        <item>巴山夜雨</item>
        <item>渭城曲</item>
        <item>春夜喜雨</item>
        <item>离离原上草</item>
        <item>示儿</item>
    </string-array>

    <string-array name="authors">
        <item>唐·李白</item>
        <item>唐·王之涣</item>
        <item>唐·王维</item>
        <item>唐·刘长卿</item>
        <item>唐·李商隐</item>
        <item>唐·李白</item>
        <item>唐·杜牧</item>
        <item>唐·王维</item>
        <item>唐·杜甫</item>
        <item>唐·白居易</item>
        <item>宋·陆游</item>
    </string-array>

    <string-array name="contents">
        <item>床前明月光，\n疑是地上霜。\n举头望明月，\n低头思故乡。</item>
        <item>白日依山尽，\n黄河入海流。\n欲穷千里目，\n更上一层楼。</item>
        <item>红豆生南国，\n春来发几枝。\n愿君多采撷，\n此物最相思。</item>
        <item>泠泠七弦上，\n静听松风寒。\n古调虽自爱，\n今人多不弹。</item>
        <item>向晚意不适，\n驱车登古原。\n夕阳无限好，\n只是近黄昏。</item>
        <item>朝辞白帝彩云间，\n千里江陵一日还。\n两岸猿声啼不住，\n轻舟已过万重山。</item>
        <item>君问归期未有期，\n巴山夜雨涨秋池。\n何当共剪西窗烛，\n却话巴山夜雨时。</item>
        <item>渭城朝雨浥轻尘，\n客舍青青柳色新。\n劝君更尽一杯酒，\n西出阳关无故人。</item>
        <item>好雨知时节，当春乃发生。\n随风潜入夜，润物细无声。\n野径云俱黑，江船火独明。\n晓看红湿处，花重锦官城。</item>
        <item>离离原上草，一岁一枯荣。\n野火烧不尽，春风吹又生。\n远芳侵古道，晴翠接荒城。\n又送王孙去，萋萋满别情。</item>
        <item>死去元知万事空，\n但悲不见九州同。\n王师北定中原日，\n家祭无忘告乃翁。 </item>
    </string-array>
</resources>

4、主布局资源文件

• 主布局资源文件activity_main.xml
  
• 查看预览效果
  

5、创建诗歌列表项模板

• 诗歌列表项模板—poem_list_item.xml
  

6、主界面功能实现

• 主界面 --MainActivity
  
• 声明变量
  
• 通过资源标识符获取控件实例
  
• 初始化诗歌标题数组，作为列表控件的数据源
  
• 创建数组适配器，作为连接列表控件与数据源的桥梁
  
  -查看平台布局资源文件–simple_list_item_1
  
• 给列表控件设置适配器
  
• 查看完整代码

package net.hw.read_ancient_poetry;

import androidx.appcompat.app.AppCompatActivity;

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

public class MainActivity extends AppCompatActivity {

    private ListView lvPoemTitle; // 诗歌标题列表控件 - 展示
    private ArrayAdapter<String> adapter; // 数组适配器 - 桥梁
    private String[] titles; // 诗歌标题数组 - 数据源

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 利用布局资源文件设置用户界面
        setContentView(R.layout.activity_main);

        // 通过资源标识符获取控件实例
        lvPoemTitle = findViewById(R.id.lv_poem_title);

        // 初始化古诗标题数组，作为列表控件的数据