Android UI组件----ListView列表控件详解

【声明】

欢迎转载，但请保留文章原始出处→_→

生命壹号：http://www.cnblogs.com/smyhvae/

文章来源：http://www.cnblogs.com/smyhvae/p/3910884.html

 

【正文】

内容简介：

• 1、基本的XML配置

• 2、ListActivity

• 3、单选和多选模式

• 4、ListView实现图文列表

• 5、ListView刷新分页

一、基本的 XML配置：

• android:cacheColorHint="#00000000"  //设置拖动背景色为透明
• android:dividerHeight="30px"  //listview item之间的高度（即分格条的高度）
• android:divider="@drawable/ic_launcher"  //设置listview item之间背景或者说是颜色
• android:fadingEdge="vertical"  //上边和下边有黑色的阴影，值为none的话就没有阴影
• android:drawSelectorOnTop="true" 点击某条记录不放，颜色会在记录的前面，成为前景色，记录上的文字被遮住，所以点击文字不放，文字就看不到（默认为false）
• android:scrollbars="horizontal|none"  //只有值为horizontal|vertical的时候（默认也是这个值），才会显示滚动条，并且会自动影藏和显示
• android:fastScrollEnabled="true"  //快速滚动效果，配置这个属性，在快速滚动的时候旁边会出现一个小方块，进行快速滚动，自动隐藏和显示（如果没有出现，是因为ListView item数目不够多）
• android:listSelector="@color/pink"  //istViewl item选中时的颜色
• android:entries="@array/citys"  //设置列表填充的内容

在ListView中加载本地数据，有两种方式，下面举例说明：（当然了，在这之前我们需要在布局文件activity_main.xml中添加一个ListView控件）

【方式一】：在xml文件中添加静态数据的方式：

在res/values/string.xml文件中， 添加一组静态数据，作为列表中将要填充的内容，代码如下

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="app_name">smyh005_ListView</string>
    <string name="action_settings">Settings</string>
    <string name="hello_world">Hello world!</string>
    
    <string-array name="names">
        <item >生命壹号</item>
        <item >生命壹号</item>
        <item >生命壹号</item>
        <item >生命壹号</item>
        <item >生命壹号</item>
        <item >生命壹号</item>
        <item >生命壹号</item>
        <item >生命壹号</item>
        <item >生命壹号</item> 
    </string-array>
    
</resources>

紧接着，在布局文件的ListView控件中，添加如下属性：

android:entries="@array/names"

然后设置一下ListView的其他属性。这样，运行后，就可以显示一个简单的列表了。

【方式二】在java代码中来添加数据：

public class MainActivity extends Activity {
    private ListView listView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        listView = (ListView) findViewById(R.id.listView1);
        String[] names = { "生命壹号", "生命壹号", "生命壹号", "生命壹号", "生命壹号", "生命壹号" };
        //第二个参数，也可以新建一个布局文件，在这个布局文件的TextView当中设置其他属性。因为每个Item本身就是一个TextView
        ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
                android.R.layout.simple_list_item_1, names);
        listView.setAdapter(adapter);
    }

【事件处理】

事件处理的监听器为：OnItemClickListener。

方法举例如下：（将当前点击的那个item的文本以吐司的方式显示出来）

listView1.setOnItemClickListener(new OnItemClickListener(){
            
            //ListView的列表项的单击事件 
            @Override
            //第一个参数：指的是这个ListView；第二个参数：当前单击的那个item
            public void onItemClick(AdapterView<?> parent, View view, int position,
                    long id) {
                System.out.println("parent="+parent.getClass());
                System.out.println("view="+view.getClass());
                
                //既然当前点击的那个item是一个TextView，那我们可以将其强制转型为TextView类型，然后通过getText()方法取出它的内容,紧接着以吐司的方式显示出来
                TextView tv = (TextView)view;
                Toast.makeText(MainActivity.this,tv.getText(),Toast.LENGTH_SHORT).show();//方法： Toast makeText (Context context, CharSequence text, int duration)                 
                
                System.out.println("position="+position);
                System.out.println("id="+id);
                
            }
            
 });

上面的第12、13行代码也可以替换成下面的这行代码：（因为通过adapter的getItem方法也可以获取对应Item，返回值类型是我们之前定义好的String类型）

        Toast.makeText(MainAcivity.this, adapter.getItem(position), Toast.LENGTH_SHORT).show;

运行效果如下：

二、ListActivity

（1）如果程序的窗口仅仅只需要显示一个列表，则可以让这个activity直接继承ListActivity来实现，此时已经包含了一个ListView组件，不用再重新写布局文件了。

代码举例如下：

package com.smyhvae.smyh005listview;
import android.app.ListActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;
public class SecondActivity extends ListActivity{
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // TODO Auto-generated method stub
        super.onCreate(savedInstanceState);
        //通过代码设置ListView中的内容
        String[] names = {"生命壹号","生命壹号","生命壹号","生命壹号","生命壹号","生命壹号"};
        //通过ArrayAdaper将names的内容填充进去
        //方法：public ArrayAdapter (Context context, int resource, int textViewResourceId),第二个参数为布局
        ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, names);
        // adpter和ListView进行绑定
        setListAdapter(adapter);
        
        //注：通过getListView()可以取出这个ListView
    }
}

运行后，也能显示出一个ListView。

（2）事件处理

事件处理的方法为：onListItemClick();

ListActiviy这个类中已经包含了事件处理的监听器，所以我们只需要复写其中的onListItemClick()即可：

    //重写ListActivity中的onListItemClick方法来实现列表项的单击事件
    @Override
    protected void onListItemClick(ListView l, View v, int position, long id) {
        // TODO Auto-generated method stub
        super.onListItemClick(l, v, position, id);
    }

（3）ListActivity的布局默认是由一个单一的在屏幕中心的全屏幕的列表，用setcontentview()在在oncreate()设置您自己的自定义屏幕布局视图布局，必须包含一个列表视图的对象ID："@android:id/list“

（4）自定义视图可以包含任何类型，显示另一个视图对象列表视图是空的，必须包含一个视图对象的ID：android:id/empty。

三、单选和多选模式：

单选模式：

        String[] cities = { "北京", "成都", "重庆", "武汉" };
        ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
                android.R.layout.simple_list_item_single_choice, cities);
        listView.setChoiceMode(ListView.CHOICE_MODE_SINGLE);

多选模式：

        String[] cities = { "北京", "成都", "重庆", "武汉" };
        ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
                android.R.layout.simple_list_item_multiple_choice, cities);
        listView.setChoiceMode(ListView.CHOICE_MODE_MULTIPLE);

五、ListView实现图文列表：

1、使用SimpleAdapter建立复杂的列表项：

使用到的方法是：

android.widget.SimpleAdapter.SimpleAdapter(Context context, List<? extends Map<String, ?>> data, int resource, String[] from, int[] to)

• 第2个参数data：每个Item就是一个Map，多个Map放在一个List当中。这个List是一个集合对象。,每一个map中应该包含所有在from参数中指定的键；（例如，data里放入图片和文字）
• 第3个参数resource：一个自定义列表项的布局文件的资源ID。布局文件将至少应包含在to中定义了的ID。（通俗来说，就是先定义一个Item的模板）
• 第4个参数from：一个将被添加到Map映射上的键名
• 第5个参数to：将绑定数据的视图的ID,跟from参数对应,这些应该全是TextView。

举例说明，完整版代码如下：

布局文件activity3.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="match_parent"
    android:orientation="vertical" >
    <ListView
        android:id="@+id/listView1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" >
    </ListView>
</LinearLayout>

下面新建一个布局文件activity_main_item.xml，作为一个Item的模板：

<?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"
    android:orientation="horizontal"
    android:gravity="center" >
    <ImageView
        android:id="@+id/imageView1"
        android:layout_width="40dp"
        android:layout_height="40dp"
        android:src="@drawable/vae" />
    <TextView
        android:id="@+id/textView1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="TextView"
        android:textSize="20sp" />
</LinearLayout>

这个布局文件展示的效果如下：

然后，MainActivity.java的代码如下：

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import android.app.Activity;
import android.os.Bundle;
import android.view.Menu;
import android.widget.ListView;
import android.widget.SimpleAdapter;
public class MainActivity extends Activity {
    private ListView listView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        listView = (ListView) findViewById(R.id.listView1);
        //步骤1 一个列表项的内容，就是一个item
        Map<String, Object> item1 = new HashMap<String, Object>();
        item1.put("image", R.drawable.vae);
        item1.put("name", "许嵩");
        //步骤1：一个列表项的内容，就是一个item，即一个Map
        Map<String, Object> item2 = new HashMap<String, Object>();
        item2.put("image", R.drawable.smyh);
        item2.put("name", "生命壹号");
        
        //步骤2：把这些Map放到List当中
        List<Map<String, Object>> data = new ArrayList<Map<String, Object>>();
        data.add(item1);
        data.add(item2);
        
        //注意：第四个参数和第五个参数要一一对应
        SimpleAdapter simpleAdapter = new SimpleAdapter(this, data,
                R.layout.activity_main_item, new String[] { "image", "name" },
                new int[] { R.id.imageView1, R.id.textView1 });
        
        //步骤3：将List中的内容填充到listView里面去
        listView.setAdapter(simpleAdapter);
    }
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.main, menu);
        return true;
    }
}

运行后，效果如下：

【工程文件】

链接：http://pan.baidu.com/s/1pJLmvJt

密码：q63j

如果item比较多的话，可以用for循环来做

2、自定义适配器BaseAdapter实现更灵活的列表：【重要】

之前使用SimpleAdapter，它的局限性在于，SimpleAdapter已经将内部的结构（即每个item）封装好了，然后按照这种格式叠加起来，无法进行额外的处理。所以，这时候可以使用BaseAdapter实现更灵活的列表。

（1）方法：实际上，就是自己写一个MyAdapter类，让它继承BaseAdapter。需要复写该类的四个方法：

• public int getCount() ：通过 adapter告诉 最要在 listView(view) 中显示 多少条目 的数据。
• public Object getItem(int position)
• public long getItemId(int position)
• public View getView(int position, View convertView, ViewGroup parent)：用来 显示 【每个条目时】 会被调用到的 方法。

最重要的是 getCount() 和 getView()。

（2）ListView 的优化：

• 重复使用convertView
• 使用ViewHolder提高在容器中查找组件的效率

完整版代码如下：

activity_main.xml：

<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:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context=".MainActivity" >
    <ListView
        android:id="@+id/listView1"
        android:layout_width="match_parent"
        android:layout_height="match_parent" >
    </ListView>
</LinearLayout>

注：为了优化，第13行的代码一定要写match_parent，而不是wrap_content，解释略。

activity_main_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"
    android:orientation="horizontal"
    android:gravity="center" >
    
    <ImageView
        android:id="@+id/imageView1"
        android:layout_width="81dp"
        android:layout_height="81dp"
        android:src="@drawable/vae" />
    <TextView
        android:id="@+id/textView1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="TextView" />    
</LinearLayout>

Mainactivity.java：

package com.smyhvae.smyh005listview4;
import android.app.Activity;
import android.os.Bundle;
import android.view.Menu;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.ImageView;
import android.widget.ListView;
import android.widget.TextView;
public class MainActivity extends Activity {
    private ListView listView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        listView = (ListView) findViewById(R.id.listView1);
        listView.setAdapter(new MyAdapter());
    }
    // 定义的数据
    private int[] images = { R.drawable.vae, R.drawable.vae, R.drawable.vae,
            R.drawable.vae, R.drawable.vae, R.drawable.vae, R.drawable.vae,
            R.drawable.vae, R.drawable.vae, R.drawable.vae, R.drawable.vae,
            R.drawable.vae };
    private String[] names = { "生命01号", "生命02号", "生命03号", "生命04号", "生命05号",
            "生命06号", "生命07号", "生命08号", "生命09号", "生命10号", "生命11号", "生命12号" };
    
    //自定义适配器
    class MyAdapter extends BaseAdapter{
        @Override
        public int getCount() {
            // TODO Auto-generated method stub
            return names.length;
        }
        @Override
        public Object getItem(int position) {
            // TODO Auto-generated method stub
            return names[position];
        }
        @Override
        public long getItemId(int position) {
            // TODO Auto-generated method stub
            return position;
        }
        @Override
        public View getView(int position, View convertView, ViewGroup parent) {
            // TODO Auto-generated method stub
//            System.out.println("position=" + position);
//            System.out.println(convertView);
//            System.out.println("------------------------");
            ViewHolder vh = new ViewHolder();
            //通过下面的条件判断语句，来循环利用。如果convertView = null ，表示屏幕上没有可以被重复利用的对象。
            if(convertView==null){
                //创建View
                convertView = getLayoutInflater().inflate(R.layout.activity_main_item, null);
                vh.iv = (ImageView) convertView.findViewById(R.id.imageView1);
                vh.tv = (TextView) convertView.findViewById(R.id.textView1);
                convertView.setTag(vh);
            }else{
                 vh = (ViewHolder)convertView.getTag();
            }
            vh.iv.setImageResource(images[position]);
            vh.tv.setText(names[position]);
            return convertView;
        }
        
    }
    
    static class ViewHolder{
        ImageView iv;
        TextView tv;
    }
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.main, menu);
        return true;
    }
}

运行效果如下：

【工程文件】

链接：http://pan.baidu.com/s/1hqvImfM

密码：oytm

五、ListView刷新分页

这个过程说来话长，具体参考本人另外一篇博客：

Android UI组件----自定义ListView实现动态刷新

 

我的公众号

想学习代码之外的软技能？不妨关注我的微信公众号：生命团队（id：vitateam）。

扫一扫，你将发现另一个全新的世界，而这将是一场美丽的意外：