Android控件学习笔记之 ListView

在android开发中ListView是比较常用的组件，它以列表的形式展示具体内容，并且能够根据数据的长度自适应显示。

 

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

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

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

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

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

ArrayAdapter参数说明

ArrayAdapter（数组适配器）一般用于显示一行文本信息，所以比较容易。

构造函数

ArrayAdapter(Context context, int textViewResourceId)

ArrayAdapter(Context context, int resource, int textViewResourceId)

ArrayAdapter(Context context, int textViewResourceId, T[] objects)

ArrayAdapter(Context context, int resource, int textViewResourceId, T[] objects)

ArrayAdapter(Context context, int textViewResourceId, List<T> objects)

ArrayAdapter(Context context, int resource, int textViewResourceId, List<T> objects)

    参数 

　　　　context　　运行着的视图的上下文。
　　　　textViewResourceId　　一个包含了TextView的布局xml文件的id。
　　　　resource　　ListView中Item项的复杂布局xml文件。
　　　　objects　　给ArrayAdapter提供数据的数组。

SimpleAdapter参数说明：

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

构造函数
    参数
　　　　context   关联SimpleAdapter运行着的视图的上下文。
　　　　data        一个Map的列表。在列表中的每个条目对应列表中的一行，应该包含所有在from中指定的条目
　　　　resource              一个定义列表项目的视图布局的资源唯一标识。布局文件将至少应包含哪些在to中定义了的名称。
　　　　from       一个将被添加到Map上关联每一个项目的列名称的列表
　　　　to    应该在参数from显示列的视图。这些应该全是TextView。在列表中最初的N视图是从参数from中最初的N列获取的值。

SimpleAdapter 可以定义各种各样的布局出来，可以放上ImageView（图片），还可以放上Button（按钮），CheckBox（复选框）等等。下面的代码都直接继承了ListActivity，如果程序的窗口仅仅为了显示一个列表，则可以直接让Activity继承ListActivity来实现，ListActivity的子类无需调用setContentView()来显示某个页面，而是可以直接传入一个Adapter，ListActivity的子类就呈现出一个列表。

SimpleCursorAdapter

SimpleCurosrAdapter 是一个将 Cursor 中的 columns 与在 XML 文件中定义的 TextViews 或 ImageViews 进行匹配的简易 adapter。你可以指定选择 Cursor 中的哪些 columns、用哪些 views 来显示这些 columns 、以及指定定义这些 views 的 xml 文件。 也就是说，SimpleCursorAdapter 允许绑定一个 Cursor 的 columns 到 ListView 上，并使用自定义的 layout 显示 List中的每个项目。可以使用 SimpleCursorAdapter 作为中间桥梁，将从 sqlite 数据库中查询出来的数据直接显示到 ListView 中。



public SimpleCursorAdapter(Context context, int layout, Cursor c, String[] from, int[] to)

构造函数
    参数

　　Context context　　这个与 SimpleListItemFactory 相关的 ListView 所处运行上下文（context）。也就是这个 ListView 所在的 Activity。

　　layout　　显示 list item 的 布局文件。这个 layout 文件中至少要包含在 "to" 参数中命名的 views。

　　c　　数据库的光标( Cursor )。如果 cursor 无效，则该参数可以为 null

　　from　　指定 column 中的哪些列的数据将绑定（显示）到 UI 中。如果 cursor 无效， 则该参数可为 null。

　　to　　指定用于显示 "from" 参数指定的数据列表的 views。 这些 views 必须都是 TextViews。 "from" 参数的前 N 个值（valus）和 "to" 参数的前 N 个 views 是一一对应的关系。如果 cursor 无效，则该参数可为 null。

SimpleAdapter列子

Main.java

package cn.test;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;

public class Main extends Activity {
    private Button btn_viewItemAndText;
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        initControl();
        setControlListener();
    }
    
    /**
     * 初始化控件
     */
    private void initControl(){
        btn_viewItemAndText=(Button)findViewById(R.id.btn_viewItemAndText);
    }
    
    /**
     * 增加控件监听
     */
    private void setControlListener(){
        btn_viewItemAndText.setOnClickListener(onClickViewItemAndTextListener);
    }
    
    /**
     * 图文列表按钮事件
     */
    private View.OnClickListener onClickViewItemAndTextListener = new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            Log.v("OnClick ", "btn_viewItemAndText");
            Intent intent = new Intent(Main.this, ItemAndTextListView.class);
            startActivity(intent);
        }
    };
}

 

ItemAndTextListView.java

package cn.test;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import android.app.ListActivity;
import android.os.Bundle;
import android.widget.SimpleAdapter;

public class ItemAndTextListView extends ListActivity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        SimpleAdapter adapter = new SimpleAdapter(this,getData(),R.layout.listitem,
                new String[]{"ItemTitle","ItemText"},
                new int[]{R.id.ItemTitle,R.id.ItemText});
        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("ItemTitle", "项目标题1");
        map.put("ItemText", "项目文字   1");
    
        list.add(map);

        map = new HashMap<String, Object>();
        map.put("ItemTitle", "项目标题2");
        map.put("ItemText", "项目文字   2");

        list.add(map);

        map = new HashMap<String, Object>();
        map.put("ItemTitle", "项目标题3");
        map.put("ItemText", "项目文字   3");
        
        list.add(map);
        
        return list;
    }
}

main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
<TextView  
    android:layout_width="fill_parent" 
    android:layout_height="wrap_content" 
    android:text="@string/hello"
    />
<Button android:layout_height="wrap_content" android:id="@+id/btn_viewItemAndText" android:text="标题加文字" android:layout_width="match_parent"></Button>

</LinearLayout>

 

listitem.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">
    <LinearLayout android:orientation="vertical"
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content">
       <TextView   
               android:layout_height="wrap_content"   
               android:layout_width="fill_parent"   
               android:id="@+id/ItemTitle"   
               android:textSize="20dip">  
       </TextView>  
       <TextView   
               android:layout_height="wrap_content"   
               android:layout_width="fill_parent"   
               android:id="@+id/ItemText">  
       </TextView> 
   </LinearLayout>
</LinearLayout>

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="cn.test"
      android:versionCode="1"
      android:versionName="1.0">
    <uses-sdk android:minSdkVersion="8" />

    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".Main"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
 
          <activity android:name=".ItemAndTextListView"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.itemAndTextListView" />
                <category android:name="android.intent.category.DEFAULT" />
            </intent-filter>
        </activity>
    </application>
</manifest>