ListView 的简单用法、个性化定制、监听事件

Love The Way You Lie 2021-09-22 11:28 431阅读 0赞

### 一、ListView 的简单用法 ###

**实现步骤：**

1. 首先新建一个项目， 并让 ADT 自动帮我们创建好活动。然后修改 activity\_main.xml 中的代码，如下所示：

<?xml version="1.0" encoding="utf-8"?>  
    http://schemas.android.com/apk/res/android"  
        xmlns:tools="http://schemas.android.com/tools"  
        android:id="@+id/activity_main"  
        android:layout_width="match_parent"  
        android:layout_height="match_parent"  
        tools:context="cn.edu.bu.a13lab07.MainActivity">  
    
        <ListView android:layout_width="match_parent" android:layout_height="match_parent" android:id="@+id/list_view" >  
        </ListView>  
    </LinearLayout>

*  在布局中加入 ListView 控件，并为 ListView 指定了一个 id 设置成 match\_parent 占满整个空间

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

2. 在 MainActivity 中

public class MainActivity extends Activity {     
    private String[] data = { "Apple", "Banana", "Orange", "Watermelon",    
    "Pear", "Grape", "Pineapple", "Strawberry", "Cherry", "Mango" };    
    @Override    
    protected void onCreate(Bundle savedInstanceState) {    
    super.onCreate(savedInstanceState);    
    setContentView(R.layout.activity_main);    
    ArrayAdapter<String> adapter = new ArrayAdapter<String>(    
    MainActivity.this, android.R.layout.simple_list_item_1, data);    
    ListView listView = (ListView) findViewById(R.id.list_view);    
    listView.setAdapter(adapter);    
    }    
    }

*  在这里我运用了系统包含的一个 TextView 的布局文件：android.R.layout.simple\_expandable\_list\_item\_1, 调用这个比较方便，
 *  ArrayAdapter adapter = new ArrayAdapter(MainActivity.this, android.R.layout.simple\_list\_item\_1, data); 的意思是：创建一个数组适配器的代码，里面有三个参数，第一个参数是上下文，就是当前的 Activity, 第二个参数是 android sdk 中自己内置的一个布局，它里面只有一个 TextView，这个参数是表明我们数组中每一条数据的布局是这个 view，就是将每一条数据都显示在这个 view 上面；第三个参数就是我们要显示的数据。listView 会根据这三个参数，遍历 data 里面的每一条数据，读出一条，显示到第二 个参数对应的布局中，这样就形成了我们看到的 listView.
 *  ArrayAdapter 是 BaseAdapter 的子类

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

3. 运行效果图：  
![运行][70]

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

### 二、定制 ListView 界面 ###

1. 训练目标

1) 掌握 ListView 控件的使用

2) 掌握如何自定义 Adapter 的使用

2. 主要参考步骤及代码

1) 定义一个实体类 Fruit，作为 ListView 适配器的适配类型。

2) 为 ListView 的子项指定一个我们自定义的布局 fruit\_item.xml。

3) 创建一个自定义的适配器 FruitAdapter，这个适配器继承自 ArrayAdapter。重写构造方法和 getView 方法。

4) 在 MainActivity 中编写，初始化水果数据

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

1、定义一个实体类 Fruit

public class Fruit {  
        private String name;  
        private int imageId;  
    
        public Fruit(String name, int imageId) {  
            this.name = name;  
            this.imageId = imageId;  
        }  
    
        public String getName() {  
            return name;  
        }  
    
        public int getImageId() {  
            return imageId;  
        }  
    }

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

2、为 ListView 的子项指定一个我们自定义的布局 fruit\_item.xml。

<?xml version="1.0" encoding="utf-8"?>  
    http://schemas.android.com/apk/res/android"  
        android:layout_width="match_parent"  
        android:layout_height="match_parent">  
        <ImageView android:id="@+id/fruit_image" android:layout_width="wrap_content" android:layout_height="wrap_content" />  
    
        <TextView android:id="@+id/fruit_name" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_gravity="center" android:layout_marginLeft="10dip" />  
    </LinearLayout>

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

3、创建一个自定义的适配器 FruitAdapter，这个适配器继承自 ArrayAdapter。重写构造方法和 getView 方法。

import android.content.Context;  
    import android.view.LayoutInflater;  
    import android.view.View;  
    import android.view.ViewGroup;  
    import android.widget.ArrayAdapter;  
    import android.widget.ImageView;  
    import android.widget.TextView;  
    
    import java.util.List;  
    
    /** * Created by lw on 2017/4/14. */  
    
    public class FruitAdapter extends ArrayAdapter{   
        private final int resourceId;  
    
        public FruitAdapter(Context context, int textViewResourceId, List<Fruit> objects) {  
            super(context, textViewResourceId, objects);  
            resourceId = textViewResourceId;  
        }  
        @Override  
        public View getView(int position, View convertView, ViewGroup parent) {  
            Fruit fruit = (Fruit) getItem(position); // 获取当前项的 Fruit 实例 
            View view = LayoutInflater.from(getContext()).inflate(resourceId, null);// 实例化一个对象 
            ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_image);// 获取该布局内的图片视图 
            TextView fruitName = (TextView) view.findViewById(R.id.fruit_name);// 获取该布局内的文本视图 
            fruitImage.setImageResource(fruit.getImageId());// 为图片视图设置图片资源 
            fruitName.setText(fruit.getName());// 为文本视图设置文本内容 
            return view;  
        }  
    }

*  View view = LayoutInflater.from(getContext()).inflate(resourceId, null); 使用 Inflater 对象来将布局文件解析成一个 View

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

4、在 MainActivity 中编写，初始化水果数据

import android.app.Activity; 
    import android.os.Bundle; 
    import android.widget.ArrayAdapter; 
    import android.widget.ListView; 
    
    import java.util.ArrayList; 
    import java.util.List; 
    
    
    public class MainActivity extends Activity {  
        private List<Fruit> fruitList = new ArrayList<Fruit>(); 
    
        @Override  
        protected void onCreate(Bundle savedInstanceState) {  
            super.onCreate(savedInstanceState); 
            setContentView(R.layout.activity_main); 
            initFruits(); // 初始化水果数据 
            FruitAdapter adapter = new FruitAdapter(MainActivity.this, R.layout.fruit_item, fruitList); 
            ListView listView = (ListView) findViewById(R.id.list_view); 
            listView.setAdapter(adapter); 
        }  
    
        private void initFruits() {  
            Fruit apple = new Fruit("Apple", R.drawable.apple_pic); 
            fruitList.add(apple); 
            Fruit banana = new Fruit("Banana", R.drawable.banana_pic); 
            fruitList.add(banana); 
            Fruit orange = new Fruit("Orange", R.drawable.orange_pic); 
            fruitList.add(orange); 
            Fruit watermelon = new Fruit("Watermelon", R.drawable.watermelon_pic); 
            fruitList.add(watermelon); 
            Fruit pear = new Fruit("Pear", R.drawable.pear_pic); 
            fruitList.add(pear); 
            Fruit grape = new Fruit("Grape", R.drawable.grape_pic); 
            fruitList.add(grape); 
            Fruit pineapple = new Fruit("Pineapple", R.drawable.pineapple_pic); 
            fruitList.add(pineapple); 
            Fruit strawberry = new Fruit("Strawberry", R.drawable.strawberry_pic); 
            fruitList.add(strawberry); 
            Fruit cherry = new Fruit("Cherry", R.drawable.cherry_pic); 
            fruitList.add(cherry); 
            Fruit mango = new Fruit("Mango", R.drawable.mango_pic); 
            fruitList.add(mango); 
        }  
    }

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

5、运行效果图

![运行][70 1]

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

### 三、ListView 的适配器 ###

1、ArrayAdapter(数组适配器)  
适用：用于绑定格式单一的数据；  
数据源：可以使集合或数组。

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

2、SimpleAdapter(简单适配器)  
适用：绑定格式复杂的数组；  
数据源：只能是特定泛型的集合。

public class MainActivity extends Activity { 
        private ListView listView;
        private SimpleAdapter sim_aAdapter; // 1. 新建一个数据适配器
    
        private List<Map<String, Object>>dataList; // 数据源
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.main);
    
            listView = (ListView)findViewById(R.id.listView1); 
    
            /** SimpleAdapter(context, data, resource, from, to) * context: 上下文 * data: 数据源(List<? extends Map<String, ?>> data),一个Map所组成的List集合 * 每个Map都会对应ListView列表中的一行，Map是由键【必须包含所有在from中所指定的键】值对组成 * resource:列表中的布局文件的ID，此处的布局是自定义的 * from:Map中的键名 * to:绑定数据视图中的ID,与from成对应关系 */  
            // 2. 适配器加载数据源
            dataList = new ArrayList<Map<String, Object>>();
            sim_aAdapter = new SimpleAdapter(this, getData(), R.layout.item, new String[]{
       "pic0", "text0"}, new int[]{R.id.pic, R.id.text}); 
            // 3. 视图(ListView)加载适配器
            listView.setAdapter(sim_aAdapter);        
        }
    
       private List<Map<String, Object>> getData(){
           for (int i = 0; i < 20; i++){
               Map<String, Object>map = new HashMap<String, Object>();
               map.put("pic0", R.drawable.ic_launcher);
               map.put("text0", "fanff"+i);
               dataList.add(map);
           }
           return dataList;
       }   
    }

*  一般来讲，简单适配器的数据源是一个集合，所以一般写一个方法来处理 (例如 getData())。

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

### 四、点击事件 ###

1、点击事件（OnItemClickListener）

onItemClick(AdapterView<?> parent, View view, int position, long id)

*  parent：官方解释为：The AdapterView where the click happened，也就是用户所点击的 AdapterView，这个参数一般不用。
 *  view：当前点击的列表项所对应的布局 View 对象，可通过这个参数获得相应的列表项内部的组件，进而对其进行操作。举个例子，假设有一个 ListView，含有 4 个列表项，你点了第 2 个，那么通过 view 你就可以操作第 2 个列表项里面的 TextView、ImageView 等等的组件（假设存在）。
 *  position：当前点击的列表项的位置，从 0 开始，也就是点击第 n 个，position 就是 n-1。
 *  id：当前点击的列表项的序号，也是从 0 开始，一般情况下 position 和 id 是一样的。

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

2、滚动事件（OnScrollListener）

**监听滚动状态的变化**

void onScrollStateChanged(AbsListView view, int scrollState)

*  view：正在被滚动的视图，也就是当前的 ListView。
 *  scrollState：滚动状态，分别有以下几种：

> SCROLL\_STATE\_TOUCH\_SCROLL：滑动状态，手指在视图滑动，并且手指一直停留在屏幕上而未离开。  
> SCROLL\_STATE\_FLING：投掷状态，手指在离开视图前，用力划了一下（想象将视图投掷出去的感觉），视图会按照惯性滑动至停止。  
> SCROLL\_STATE\_IDLE：闲置状态，什么都没做的状态。当投掷状态或触摸滚动状态结束时，进入闲置状态。

public class MainActivity extends Activity implements AdapterView.OnItemClickListener{ 
    
        private ListView myListView;
        private SimpleAdapter simpleAdapter;
        private List<Map<String, Object>> data;
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
    
            data = new ArrayList<Map<String, Object>>();
            simpleAdapter = new SimpleAdapter(this, getData(), R.layout.item, new String[]{
       "img", "text"}, new int[]{R.id.img, R.id.text});
            myListView = (ListView) findViewById(R.id.myListView);
            //设置监听器
            myListView.setAdapter(simpleAdapter);
            myListView.setOnItemClickListener(this);
        }
    
        private List<Map<String, Object>> getData() {
            for (int i = 0; i < 20; i++) {
                Map<String, Object>map = new HashMap<String, Object>();
                map.put("img", R.mipmap.ic_launcher);
                map.put("text", "初始simpleAdapter"+(i+1));
                data.add(map);
            }
    
            return data;
        }
    
        @Override
        public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
            //通过view获取其内部的组件，进而进行操作
            String text = (String) ((TextView)view.findViewById(R.id.text)).getText();
            //大多数情况下，position和id相同，并且都从0开始
            String showText = "点击第" + position + "项，文本内容为：" + text + "，ID为：" + id;
            Toast.makeText(this, showText, Toast.LENGTH_LONG).show();
        }
    }

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

**监听非滚动状态，只要 ListView 不滚动，就会被不断调用**

void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount)

*  view：正在被滚动的视图，也就是当前的 ListView。
 *  firstVisibleItem：已加载的第一个列表项的索引值。
 *  visibleItemCount：已加载的列表项的总数。
 *  totalItemCount：适配器中数据源对应的列表项总数。

public class MainActivity extends Activity implements AbsListView.OnScrollListener{ 
    
        private ListView myListView;
        private SimpleAdapter simpleAdapter;
        private List<Map<String, Object>> data;
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
    
            data = new ArrayList<Map<String, Object>>();
            simpleAdapter = new SimpleAdapter(this, getData(), R.layout.item, new String[]{
       "img", "text"}, new int[]{R.id.img, R.id.text});
            myListView = (ListView) findViewById(R.id.myListView);
            myListView.setAdapter(simpleAdapter);
    
            //设置监听器
            myListView.setOnScrollListener(this);
        }
    
        private List<Map<String, Object>> getData() {
            for (int i = 0; i < 20; i++) {
                Map<String, Object>map = new HashMap<String, Object>();
                map.put("img", R.mipmap.ic_launcher);
                map.put("text", "初始simpleAdapter"+(i+1));
                data.add(map);
            }
    
            return data;
        }
    
        @Override
        public void onScrollStateChanged(AbsListView view, int scrollState) {
            switch (scrollState) {
                //投掷状态
                case SCROLL_STATE_FLING:
                    Toast.makeText(this, "SCROLL_STATE_FLING", Toast.LENGTH_SHORT).show();
                    break;
                //闲置状态
                case SCROLL_STATE_IDLE:
                    Toast.makeText(this, "SCROLL_STATE_IDLE", Toast.LENGTH_SHORT).show();
                    break;
                //滑动状态
                case SCROLL_STATE_TOUCH_SCROLL:
                    Toast.makeText(this, "SCROLL_STATE_TOUCH_SCROLL", Toast.LENGTH_SHORT).show();
                    break;
            }
        }
    
        @Override
        public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {
    // Toast.makeText(this, "滚动已停止，已加载的第一项的索引为：" + firstVisibleItem +
    // "，已加载的列表项总数为：" + visibleItemCount + "，存在的列表项总数为：" +
    // totalItemCount, Toast.LENGTH_LONG).show();
        }
    }

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

转自：[https://blog.csdn.net/lw\_android1/article/details/70170950][https_blog.csdn.net_lw_android1_article_details_70170950]

[70]: /images/20210920/2ea7036a3f2f44469af3e730c92322b5.png
[70 1]: /images/20210920/281dab7757984b139dd71ecbd55931f9.png
[https_blog.csdn.net_lw_android1_article_details_70170950]: https://blog.csdn.net/lw_android1/article/details/70170950