android ListView android 核心控件详解

恋恋西风

已于 2023-02-19 00:02:06 修改

阅读量2k

点赞数 1

分类专栏： android 开发进阶文章标签： android java ListView

于 2015-02-23 23:49:08 首次发布

本文链接：https://blog.csdn.net/q610098308/article/details/43920057

版权

android 开发进阶专栏收录该内容

14 篇文章 0 订阅

订阅专栏

简介：

在Android所有常用的原生控件当中，用法最复杂的应该就是ListView了，它专门用于处理那种内容元素很多，手机屏幕无法展示出所有内容的情况。 ListView可以使用列表的形式来展示内容，超出屏幕部分的内容只需要通过手指滑动就可以移动到屏幕内了

列表的显示需要三个元素：

1．ListVeiw 用来展示列表的View。

2．适配器用来把数据映射到ListView上的中介。

3．数据具体的将被映射的字符串，图片，或者基本组件。

根据列表的适配器类型，列表分为三种，ArrayAdapter，SimpleAdapter和SimpleCursorAdapter

其中以ArrayAdapter最为简单，只能展示一行字。SimpleAdapter有最好的扩充性，可以自定义出各种效果。SimpleCursorAdapter可以认为是SimpleAdapter对数据库的简单结合，可以方面的把数据库的内容以列表的形式展示出来。

我们从最简单的ListView开始：

/**

* @author allin

*

*/

public class MyListView extends Activity {

private ListView listView;

//private List<String> data = new ArrayList<String>();

@Override

public void onCreate(Bundle savedInstanceState){

super .onCreate(savedInstanceState);

listView = new ListView( this );

listView.setAdapter( new ArrayAdapter<String>( this , android.R.layout.simple_expandable_list_item_1,getData()));

setContentView(listView);

}

private List<String> getData(){

List<String> data = new ArrayList<String>();

data.add( "测试数据1" );

data.add( "测试数据2" );

data.add( "测试数据3" );

data.add( "测试数据4" );

return data;

}

上面代码使用了ArrayAdapter(Context context, int textViewResourceId, List<T> objects)来装配数据，要装配这些数据就需要一个连接ListView视图对象和数组数据的适配器来两者的适配工作，ArrayAdapter的构造需要三个参数，依次为this,布局文件（注意这里的布局文件描述的是列表的每一行的布局，android.R.layout.simple_list_item_1是系统定义好的布局文件只显示一行文字，数据源(一个List集合)。同时用setAdapter（）完成适配的最后工作。运行后的现实结构如下图：

SimpleCursorAdapter

　　sdk的解释是这样的：An easy adapter to map columns from a cursor to TextViews or ImageViews defined in an XML file. You can specify which columns you want, which views you want to display the columns, and the XML file that defines the appearance of these views。简单的说就是方便把从游标得到的数据进行列表显示，并可以把指定的列映射到对应的TextView中。

　　下面的程序是从电话簿中把联系人显示到类表中。先在通讯录中添加一个联系人作为数据库的数据。然后获得一个指向数据库的Cursor并且定义一个布局文件（当然也可以使用系统自带的）。

/**

* @author allin

*

*/

public class MyListView2 extends Activity {

private ListView listView;

//private List<String> data = new ArrayList<String>();

@Override

public void onCreate(Bundle savedInstanceState){

super .onCreate(savedInstanceState);

listView = new ListView( this );

Cursor cursor = getContentResolver().query(People.CONTENT_URI, null , null , null , null );

startManagingCursor(cursor);

ListAdapter listAdapter = new SimpleCursorAdapter( this , android.R.layout.simple_expandable_list_item_1,

cursor,

new String[]{People.NAME},

new int []{android.R.id.text1});

listView.setAdapter(listAdapter);

setContentView(listView);

}

　Cursor cursor = getContentResolver().query(People.CONTENT_URI, null, null, null, null);先获得一个指向系统通讯录数据库的Cursor对象获得数据来源。

　startManagingCursor(cursor);我们将获得的Cursor对象交由Activity管理，这样Cursor的生命周期和Activity便能够自动同步，省去自己手动管理Cursor。

　SimpleCursorAdapter 构造函数前面3个参数和ArrayAdapter是一样的，最后两个参数：一个包含数据库的列的String型数组，一个包含布局文件中对应组件id的int型数组。其作用是自动的将String型数组所表示的每一列数据映射到布局文件对应id的组件上。上面的代码，将NAME列的数据一次映射到布局文件的id为text1的组件上。

注意：需要在AndroidManifest.xml中如权限：<uses-permission android:name="android.permission.READ_CONTACTS"></uses-permission>

运行后效果如下图：

SimpleAdapter

simpleAdapter的扩展性最好，可以定义各种各样的布局出来，可以放上ImageView（图片），还可以放上Button（按钮），CheckBox（复选框）等等。下面的代码都直接继承了ListActivity，ListActivity和普通的Activity没有太大的差别，不同就是对显示ListView做了许多优化，方面显示而已。

下面的程序是实现一个带有图片的类表。

首先需要定义好一个用来显示每一个列内容的xml

vlist.xml

<? xml version="1.0" encoding="utf-8"?>

< LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

android:orientation="horizontal" android:layout_width="fill_parent"

android:layout_height="fill_parent">

< ImageView android:id="@+id/img"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_margin="5px"/>

< LinearLayout android:orientation="vertical"

android:layout_width="wrap_content"

android:layout_height="wrap_content">

< TextView android:id="@+id/title"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:textColor="#FFFFFFFF"

android:textSize="22px" />

< TextView android:id="@+id/info"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:textColor="#FFFFFFFF"

android:textSize="13px" />

</ LinearLayout >

下面是实现代码：

/**

* @author allin

*

*/

public class MyListView3 extends ListActivity {

// private List<String> data = new ArrayList<String>();

@Override

public void onCreate(Bundle savedInstanceState) {

super .onCreate(savedInstanceState);

SimpleAdapter adapter = new SimpleAdapter( this ,getData(),R.layout.vlist,

new String[]{ "title" , "info" , "img" },

new int []{R.id.title,R.id.info,R.id.img});

setListAdapter(adapter);

}

private List<Map<String, Object>> getData() {

List<Map<String, Object>> list = new ArrayList<Map<String, Object>>();

Map<String, Object> map = new HashMap<String, Object>();

map.put( "title" , "G1" );

map.put( "info" , "google 1" );

map.put( "img" , R.drawable.i1);

list.add(map);

map = new HashMap<String, Object>();

map.put( "title" , "G2" );

map.put( "info" , "google 2" );

map.put( "img" , R.drawable.i2);

list.add(map);

map = new HashMap<String, Object>();

map.put( "title" , "G3" );

map.put( "info" , "google 3" );

map.put( "img" , R.drawable.i3);

list.add(map);

return list;

}

使用simpleAdapter的数据用一般都是HashMap构成的List，list的每一节对应ListView的每一行。HashMap的每个键值数据映射到布局文件中对应id的组件上。因为系统没有对应的布局文件可用，我们可以自己定义一个布局vlist.xml。下面做适配，new一个SimpleAdapter参数一次是：this，布局文件（vlist.xml），HashMap的 title 和 info，img。布局文件的组件id，title，info，img。布局文件的各组件分别映射到HashMap的各元素上，完成适配。

运行效果如下图：

有按钮的ListView

但是有时候，列表不光会用来做显示用，我们同样可以在在上面添加按钮。添加按钮首先要写一个有按钮的xml文件，然后自然会想到用上面的方法定义一个适配器，然后将数据映射到布局文件上。但是事实并非这样，因为按钮是无法映射的，即使你成功的用布局文件显示出了按钮也无法添加按钮的响应，这时就要研究一下ListView是如何现实的了，而且必须要重写一个类继承BaseAdapter。下面的示例将显示一个按钮和一个图片，两行字如果单击按钮将删除此按钮的所在行。并告诉你ListView究竟是如何工作的。效果如下：

vlist2.xml

<? xml version="1.0" encoding="utf-8"?>

< LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

android:orientation="horizontal"

android:layout_width="fill_parent"

android:layout_height="fill_parent">

< ImageView android:id="@+id/img"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_margin="5px"/>

< LinearLayout android:orientation="vertical"

android:layout_width="wrap_content"

android:layout_height="wrap_content">

< TextView android:id="@+id/title"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:textColor="#FFFFFFFF"

android:textSize="22px" />

< TextView android:id="@+id/info"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:textColor="#FFFFFFFF"

android:textSize="13px" />

</ LinearLayout >

< Button android:id="@+id/view_btn"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="@string/s_view_btn"

android:layout_gravity="bottom|right" />

</ LinearLayout >

程序代码：

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

/**

* @author allin

*

*/

public class MyListView4 extends ListActivity {

private List<Map<String, Object>> mData;

@Override

public void onCreate(Bundle savedInstanceState) {

super .onCreate(savedInstanceState);

mData = getData();

MyAdapter adapter = new MyAdapter( this );

setListAdapter(adapter);

}

private List<Map<String, Object>> getData() {

List<Map<String, Object>> list = new ArrayList<Map<String, Object>>();

Map<String, Object> map = new HashMap<String, Object>();

map.put( "title" , "G1" );

map.put( "info" , "google 1" );

map.put( "img" , R.drawable.i1);

list.add(map);

map = new HashMap<String, Object>();

map.put( "title" , "G2" );

map.put( "info" , "google 2" );

map.put( "img" , R.drawable.i2);

list.add(map);

map = new HashMap<String, Object>();

map.put( "title" , "G3" );

map.put( "info" , "google 3" );

map.put( "img" , R.drawable.i3);

list.add(map);

return list;

}

// ListView 中某项被选中后的逻辑

@Override

protected void onListItemClick(ListView l, View v, int position, long id) {

Log.v( "MyListView4-click" , (String)mData.get(position).get( "title" ));

}

/**

* listview中点击按键弹出对话框

*/

public void showInfo(){

new AlertDialog.Builder( this )

.setTitle( "我的listview" )

.setMessage( "介绍..." )

.setPositiveButton( "确定" , new DialogInterface.OnClickListener() {

@Override

public void onClick(DialogInterface dialog, int which) {

}

})

.show();

}

public final class ViewHolder{

public ImageView img;

public TextView title;

public TextView info;

public Button viewBtn;

}

public class MyAdapter extends BaseAdapter{

private LayoutInflater mInflater;

public MyAdapter(Context context){

this .mInflater = LayoutInflater.from(context);

}

@Override

public int getCount() {

// TODO Auto-generated method stub

return mData.size();

}

@Override

public Object getItem( int arg0) {

// TODO Auto-generated method stub

return null ;

}

@Override

public long getItemId( int arg0) {

// TODO Auto-generated method stub

return 0 ;

}

@Override

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

ViewHolder holder = null ;

if (convertView == null ) {

holder= new ViewHolder();

convertView = mInflater.inflate(R.layout.vlist2, null );

holder.img = (ImageView)convertView.findViewById(R.id.img);

holder.title = (TextView)convertView.findViewById(R.id.title);

holder.info = (TextView)convertView.findViewById(R.id.info);

holder.viewBtn = (Button)convertView.findViewById(R.id.view_btn);

convertView.setTag(holder);

} else {

holder = (ViewHolder)convertView.getTag();

}

holder.img.setBackgroundResource((Integer)mData.get(position).get( "img" ));

holder.title.setText((String)mData.get(position).get( "title" ));

holder.info.setText((String)mData.get(position).get( "info" ));

holder.viewBtn.setOnClickListener( new View.OnClickListener() {

@Override

public void onClick(View v) {

showInfo();

}

});

return convertView;

}

　　下面将对上述代码，做详细的解释，listView在开始绘制的时候，系统首先调用getCount（）函数，根据他的返回值得到listView的长度（这也是为什么在开始的第一张图特别的标出列表长度），然后根据这个长度，调用getView（）逐一绘制每一行。如果你的getCount（）返回值是0的话，列表将不显示同样return 1，就只显示一行。

　　系统显示列表时，首先实例化一个适配器（这里将实例化自定义的适配器）。当手动完成适配时，必须手动映射数据，这需要重写getView（）方法。系统在绘制列表的每一行的时候将调用此方法。getView()有三个参数，position表示将显示的是第几行，covertView是从布局文件中inflate来的布局。我们用LayoutInflater的方法将定义好的vlist2.xml文件提取成View实例用来显示。然后将xml文件中的各个组件实例化（简单的findViewById()方法）。这样便可以将数据对应到各个组件上了。但是按钮为了响应点击事件，需要为它添加点击监听器，这样就能捕获点击事件。至此一个自定义的listView就完成了，现在让我们回过头从新审视这个过程。系统要绘制ListView了，他首先获得要绘制的这个列表的长度，然后开始绘制第一行，怎么绘制呢？调用getView()函数。在这个函数里面首先获得一个View（实际上是一个ViewGroup），然后再实例并设置各个组件，显示之。好了，绘制完这一行了。那再绘制下一行，直到绘完为止。在实际的运行过程中会发现listView的每一行没有焦点了，这是因为Button抢夺了listView的焦点，只要布局文件中将Button设置为没有焦点就OK了。

运行效果如下图：

源码下载

listView的重要属性

android:transcriptMode="alwaysScroll"  

android:cacheColorHint="#00000000"

android:listSelector="@color/pink" listView item 选中时的颜色。默认为橙黄底色。


android:divider="#f9b68b"  //分割线颜色

android:dividerHeight="1dp"  //分割线边距

android:scrollbars="none"  //不显示滚动条

android:fadingEdge="none"   去掉上边和下边黑色的阴影


// 设置Item之间无间隙

android:divider="#00000000" 或者在javaCode中如下定义：listView.setDividerHeight(0);

android:divider="@drawable/list_driver" 设置分割线的图片资源，如果则只要设置为

android:divider="@drawable/@null" 不想显示分割线


android:scrollbars="none" setVerticalScrollBarEnabled(true); 隐藏listView的滚动条

android:fadeScrollbars="true" 设置为true就可以实现滚动条的自动隐藏和显示

android:transcriptMode="alwaysScroll" 用ListView或者其它显示大量Items的控件实时跟踪或者查看信息,希望最新的条目可以自动滚动到可视范围内。通过设置的控件transcriptMode属性可以将Android平台的控件（支持ScrollBar）自动滑动到最底部。

android:fadingEdge="none" 去掉上边和下边黑色的阴影

android:fastScrollEnabled="false"
android:fastScrollEnabled = "true" 加快滑动速度

android:drawSelectorOnTop="false"
android:scrollingCache="false"

android:drawSelectorOnTop="true" 点击某一条记录，颜色会显示在最上面，记录上的文字被遮住，所以点击文字不放，文字就看不到

android:drawSelectorOnTop="false" 点击某条记录不放，颜色会在记录的后面，成为背景色，但是记录内容的文字是可见的

首先是stackFromBottom属性，这只该属性之后你做好的列表就会显示你列表的最下面，值为true和false

android:stackFromBottom="true"

第二是transciptMode属性，需要用ListView或者其它显示大量Items的控件实时跟踪或者查看信息，并且希望最新的条目可以自动滚动到可视范围内。通过设置的控件transcriptMode属性可以将Android平台的控件（支持ScrollBar）自动滑动到最底部。
android:transcriptMode="alwaysScroll"

第三cacheColorHint属性，很多人希望能够改变一下它的背景，使他能够符合整体的UI设计，改变背景背很简单只需要准备一张图片然后指定属性 android:background="@drawable/bg"，不过不要高兴地太早，当你这么做以后，发现背景是变了，但是当你拖动，或者点击list空白位置的时候发现ListItem都变成黑色的了，破坏了整体效果。

如果你只是换背景的颜色的话，可以直接指定android:cacheColorHint为你所要的颜色，如果你是用图片做背景的话，那也只要将android:cacheColorHint指定为透明（#00000000）就可以了

第四divider属性，该属性作用是每一项之间需要设置一个图片做为间隔，或是去掉item之间的分割线

android:divider="@drawable/list_driver" 其中 @drawable/list_driver 是一个图片资源，如果不想显示分割线则只要设置为android:divider="@drawable/@null" 就可以了

第五fadingEdge属性，上边和下边有黑色的阴影

android:fadingEdge="none" 设置后没有阴影了~

第六scrollbars属性，作用是隐藏listView的滚动条，

android:scrollbars="none"与setVerticalScrollBarEnabled(true);的效果是一样的，不活动的时候隐藏，活动的时候也隐藏

第七fadeScrollbars属性，android:fadeScrollbars="true" 配置ListView布局的时候，设置这个属性为true就可以实现滚动条的自动隐藏和显示。

第八fastScrollEnabled属性 ,

很多开发者不知道ListView列表控件的快速滚动滑块是如何启用的，这里Android开发网告诉大家，辅助滚动滑块只需要一行代码就可以搞定，如果你使用XML布局只需要在ListView节点中加入 android:fastScrollEnabled="true" 这个属性即可，而对于Java代码可以通过myListView.setFastScrollEnabled(true); 来控制启用，参数false为隐藏。还有一点就是当你的滚动内容较小，不到当前ListView的3个屏幕高度时则不会出现这个快速滚动滑块，同时该方法仍然是AbsListView的基础方法，可以在ListView或GridView等子类中使用快速滚动辅助。

第九drawSelectorOnTop属性

When set to true, the selector will be drawn over the selecteditem. Otherwise the selector is drawn behind the selected item. Thedefault value is false.

android:drawSelectorOnTop="true" 点击某一条记录，颜色会显示在最上面，记录上的文字被遮住，所以点击文字不放，文字就看不到

android:drawSelectorOnTop="false"点击某条记录不放，颜色会在记录的后面，成为背景色，但是记录内容的文字是可见的