安卓列表视图

淩亂°似流年 2024-03-30 10:51 155阅读 0赞

**目录**

理论：

列表视图概述

列表视图API文档

列表视图四要素

四种常用适配器

数组适配器API文档

数组适配器构造方法

第5个构造方法的参数说明

具体例子：阅读古诗

基于Empty Activity模板创建安卓应用 - ReadAncientPoetry

将背景图片拷贝到drawable目录

打开字符串资源文件 strings.xml输入代码：

打开主布局资源文件 activity\_main.xml

新建诗歌列表项模板 poem\_list\_item.xml并输入代码

打开主界面类 - MainActivity输入代码

启动应用查看效果

创建内容界面

修改内容界面，显示古诗内容

启动应用查看效果：

--------------------

### 理论： ###

#### 列表视图概述 ####

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

#### 列表视图API文档 ####

[https://developer.android.google.cn/reference/android/widget/ArrayAdapter?hl=en][https_developer.android.google.cn_reference_android_widget_ArrayAdapter_hl_en]

![1ff5f5c5e1ed4a5ea673d4d197b00529.png][]

#### 列表视图四要素 ####

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

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

![102144f73cc2414db102da1fea4bfc69.png][]

#### 四种常用适配器 ####

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

<table> 
 <tbody> 
  <tr> 
   <th>适配器</th> 
   <th>含义</th> 
  </tr> 
  <tr> 
   <td>ArrayAdapter</td> 
   <td>数组适配器</td> 
  </tr> 
  <tr> 
   <td>SimpleAdapter</td> 
   <td>简单适配器</td> 
  </tr> 
  <tr> 
   <td>SimpleCursorAdapter</td> 
   <td>简单游标适配器</td> 
  </tr> 
  <tr> 
   <td>BaseAdapter</td> 
   <td>基适配器</td> 
  </tr> 
 </tbody> 
</table>

#### 数组适配器API文档 ####

[https://developer.android.google.cn/reference/android/widget/ArrayAdapter?hl=en][https_developer.android.google.cn_reference_android_widget_ArrayAdapter_hl_en]

#### 数组适配器构造方法 ####

数组适配器提供了6个重载的构造方法下面的案例我们会用第五种方法。

![d971e0bf3d1f4d0c85e31c421de9dbdb.png][]

#### 第5个构造方法的参数说明 ####

![c37bbf30e02c4188a3f7c5f03e1163cf.png][]

### 具体例子：阅读古诗 ###

#### 基于`Empty Activity`模板创建安卓应用 - `ReadAncientPoetry` ####

![023e1fc8a0f940b4b4fb812d4aff04f2.png][]

#### 将背景图片拷贝到`drawable`目录 ####

![3cc2ea52bafc427cb77babd907fc65fb.png][]

#### 打开字符串资源文件 `strings.xml输入代码：` ####

![744dfcbdda0d435e9561699f185d579f.png][]

具体代码：

<resources>
        <string name="app_name">阅读古诗</string>
        <string name="back">返回目录</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>

#### 打开主布局资源文件 `activity_main.xml` ####

![ed5fa841860841259500e9488f83f53e.png][]

具体代码:

<?xml version="1.0" encoding="utf-8"?>
    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="@drawable/background"
        android:padding="15dp"
        tools:context=".MainActivity">
    
        <ListView
            android:id="@+id/lv_poem_title"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:divider="#aaaaaa"
            android:dividerHeight="0.5dp"
            />
    
    
    </LinearLayout>

#### 新建诗歌列表项模板 `poem_list_item.xml并输入代码` ####

![dcfde4a7b65249c8a8d0bc042e37ceae.png][]

![746d83b6c12049babeec378059300db2.png][]

具体代码：

<?xml version="1.0" encoding="utf-8"?>
    <TextView xmlns:android="http://schemas.android.com/apk/res/android"
        android:id="@+id/tv_poem_title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center_vertical"
        android:minHeight="80dp"
        android:textColor="#0000ff"
        android:textSize="25sp" />

#### 打开主界面类 - `MainActivity输入代码` ####

![91e318cf4fd347ba8562839588bdf726.png][]

![9384f48b55294e5d9f262cbb8a24cef5.png][]

具体代码：

package net.zyt.read_ancient_poetry;
    
    import androidx.appcompat.app.AppCompatActivity;
    
    import android.content.Intent;
    import android.os.Bundle;
    import android.view.View;
    import android.widget.AdapterView;
    import android.widget.ArrayAdapter;
    import android.widget.ListView;
    import android.widget.Toast;
    
    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);
    
            //初始化古诗标题数组，作为列表控件的数据源
           titles=getResources().getStringArray(R.array.titles);
            //给诗歌标题添上序号
            for (int i=0; i<titles.length;i++){
                titles[i]=(i+1)+"."+titles[i];
            }
            //创建数组适配器，作为连接列表控件与数据源的桥梁
            adapter=new ArrayAdapter<>(
                    this,//上下文-当前窗口
                    R.layout.poem_list_item,//列表项模板-自定义布局资源
                    titles//数据源-字符串数据组
            );
            //给列表控件设置适配器
            lvPoemTitle.setAdapter(adapter);
            //给列表控件注册项单击监听器
            lvPoemTitle.setOnItemClickListener(new AdapterView.OnItemClickListener() {
                @Override
                public void onItemClick(AdapterView<?> adapterView, View view, int position, long id) {
                    Toast.makeText(MainActivity.this,"你选择了古诗["+titles[position]+"]",Toast.LENGTH_SHORT).show();
               //创建意图实现跳转
                    Intent intent=new Intent(MainActivity.this,ContentActivity.class);
                    //通过意图携带数据（选中的列表项位置）
                    intent.putExtra("position",position);
                    //按意图启动目标主键
                    startActivity(intent);
    
                }
            });
        }
    }

#### 启动应用查看效果 ####

![83f1d0b1444d42b185f5e12fe10b2018.png][]

#### 创建内容界面 ####

基于模板创建显示古诗内容的界面`ContentActivity`

![edec66486b4948f482bb54d657bc6d4e.png][]

打开 界面布局资源文件`content_activity.xml输入代码：`

![4c258c2dc2b24037956b06d1b6e51f11.png][]

具体代码：

<?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:background="@drawable/background"
        android:paddingRight="10dp"
        android:gravity="center"
        android:orientation="vertical">
    
        <TextView
            android:id="@+id/tv_title"
            android:layout_width="wrap_content"
            android:layout_height="0dp"
            android:layout_marginTop="30dp"
            android:layout_marginBottom="20dp"
            android:layout_weight="1"
            android:gravity="center_vertical"
            android:textColor="#ff00ff"
            android:textSize="40sp" />
    
        <TextView
            android:id="@+id/tv_author"
            android:layout_width="wrap_content"
            android:layout_height="0dp"
            android:layout_marginBottom="20dp"
            android:layout_weight="1"
            android:gravity="center_vertical"
            android:textColor="#000000"
            android:textSize="25sp" />
    
        <TextView
            android:id="@+id/tv_content"
            android:layout_width="wrap_content"
            android:layout_height="0dp"
            android:layout_marginBottom="20dp"
            android:layout_weight="8"
            android:textColor="#0000ff"
            android:textSize="30sp" />
    
        <Button
            android:id="@+id/btn_back"
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1"
            android:onClick="doBack"
            android:text="@string/back"
            android:textSize="20sp" />
    </LinearLayout>

#### 修改内容界面，显示古诗内容 ####

打开内容界面`ContentActivity`

![cd32cedf338a4dffb6faefb91fdbe85a.png][]

具体代码：

package net.zyt.read_ancient_poetry;
    
    import androidx.appcompat.app.AppCompatActivity;
    
    import android.content.Intent;
    import android.os.Bundle;
    import android.view.View;
    import android.widget.TextView;
    
    public class ContentActivity extends AppCompatActivity {
        private TextView tvTitle;//标题标签
        private TextView tvAuthor;//作者标签
        private TextView tvContent;//内容标签
        private String[] titles;//标题数组
        private String[] authors;//作者数组
        private String[] contents;//内容数组
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            //利用布局资源文件设置用户界面
            setContentView(R.layout.activity_content);
            //通过资源标识符获取控件实例
            tvTitle=findViewById(R.id.tv_title);
            tvAuthor=findViewById(R.id.tv_author);
            tvContent=findViewById(R.id.tv_content);
            //获取窗口跳转的意图
            Intent intent=getIntent();
            //判断意图是否为空
            if (intent!=null){
                //获取意图携带数据
                int position=intent.getIntExtra("position",0);
                //获取古诗标题数组
                titles=getResources().getStringArray(R.array.titles);
                //获取古诗作者数组
                authors=getResources().getStringArray(R.array.authors);
                //获取古诗内容标签
                contents=getResources().getStringArray(R.array.contents);
                //设置标题标签文本
                tvTitle.setText(titles[position]);
                //设置作者标签文本
                tvAuthor.setText(authors[position]);
                //设置内容标签文本
                tvContent.setText(contents[position]);
    
            }
        }
        public void doBack(View view){
            finish();//关闭当前窗口
        }
    }

#### 启动应用查看效果： ####

![04076f0de17943fba225f1337ad5daf6.gif][]

[https_developer.android.google.cn_reference_android_widget_ArrayAdapter_hl_en]: https://developer.android.google.cn/reference/android/widget/ArrayAdapter?hl=en
[1ff5f5c5e1ed4a5ea673d4d197b00529.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/1f9a6528a8b64f3a952604dc4aa13154.png
[102144f73cc2414db102da1fea4bfc69.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/873a4bee6623455fa88535f7e25bb1c7.png
[d971e0bf3d1f4d0c85e31c421de9dbdb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/1f555f51346b4465bf663e5cdf4bdabf.png
[c37bbf30e02c4188a3f7c5f03e1163cf.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/e535a0f8245646bfb3363f7d1dfa31e9.png
[023e1fc8a0f940b4b4fb812d4aff04f2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/7a7b6525385642fa9aa47f8c9d3f9562.png
[3cc2ea52bafc427cb77babd907fc65fb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/c92e5a26e7e34e348f68b0a6bc3da4fd.png
[744dfcbdda0d435e9561699f185d579f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/b1cdc384a8894b14b95779828f32b0f4.png
[ed5fa841860841259500e9488f83f53e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/75939aa2fca24f0982dd98740952bb0f.png
[dcfde4a7b65249c8a8d0bc042e37ceae.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/cd5fd9298fca4451a1b789fa03bed613.png
[746d83b6c12049babeec378059300db2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/cf01ec79c1404e87868996bce2621482.png
[91e318cf4fd347ba8562839588bdf726.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/0c92ff6fe50a4f43b8177e56f6882e35.png
[9384f48b55294e5d9f262cbb8a24cef5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/ac8b56a298354b96aa393083adcbc6f0.png
[83f1d0b1444d42b185f5e12fe10b2018.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/6cb514b2fbe047daa9fd27a19c93d611.png
[edec66486b4948f482bb54d657bc6d4e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/ee2beaf352b140f8b28d54335e0d09c7.png
[4c258c2dc2b24037956b06d1b6e51f11.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/bbba550553a74a5cb931edff7acbf957.png
[cd32cedf338a4dffb6faefb91fdbe85a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/2d6a4afe305245deb7f98bb12f87bba6.png
[04076f0de17943fba225f1337ad5daf6.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/05147dd86053456dbbac49dc860bdbb1.gif