Android关于ListView的总结--使用ListActivity

  ListActivity是一个专门显示ListView的Activity类，它内置了ListView对象，实现数据源的绑定与显示，数据源通常会是一个array或者一个拥有查询结果的cursor. 只要我们设置了数据源，ListView就会自动地显示出来。

    ListActivity本身有一个默认的layout，其中包含一个全屏的list。如果用默认的layout，必须在onCreate()中注释掉setContentView()那一句。 

    虽然ListActivity内置ListView对象有默认的layout，但我们依然可以使用custom view，通过在onCreate()里面调用setContentView(resources id)。不过要注意的是，在自定义的Layout里面，必须包括一个（只能一个）ListView，而且要设置ListView对象的id为"@android:id/list"；在Java代码里使用android.R.id.list。

下面的例子，如果当ListView中没有值而又想提示一句话时，那么用于指定显示提示信息的TextView的 id 必须为 "@android:id/empty"，提示的信息可以通过android:text进行指定，当ListView里面没有data的时候，就会显示"No data"。

 

自定义的View (listview.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">

        <ListView android:id="@id/android:list"
                android:layout_width="fill_parent"
                android:layout_height="fill_parent"
                android:layout_weight="1"
        />

        <TextView android:id="@id/android:empty"
                android:layout_width="fill_parent"
                android:layout_height="wrap_content"
                android:text="No data"
                android:textColor="#ff0000"
        />
</LinearLayout>

加载Layout：

@Override
public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.listview);

        //没有设置data source
}

 

官方提供了多种ListItem的Layout (R.layout)，以下是较为常用的：

§  android.R.layout.simple_list_item_1   一行text

§  android.R.layout.simple_list_item_2   一行title，一行text

§  android.R.layout.simple_list_item_single_choice   单选按钮

§  android.R.layout.simple_list_item_multiple_choice   多选按钮

§  android.R.layout.simple_list_item_checked    checkbox

我们可以自定义自己的Layout (list_item.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/icon"
                android:layout_width="48dip"
                android:layout_height="48dip" />

        <TextView android:id="@+id/text"
                android:layout_gravity="center_vertical"
                android:layout_width="0dip"
                android:layout_weight="1"
                android:layout_height="wrap_content" />

</LinearLayout>

使用时，以R.layout.list_item引用就行了。

 

通过调用SetListAdapter(ListAdapter adapter)就可实现数据的绑定。我们可以implements ListAdapter来自定义自己的数据源。 API内置了几个已经implements ListAdapter的Adapter：BaseAdapter，SimpleAdapter (以Map的形式存储静态数据)，SimpleCursorAdapter (用于游标查询的结果)等等。通常我们更多地extends BaseAdapter来编写自己的Adapter类，因为BaseAdapter类是其他Apdater类的基类。扩展BaseAdapter类一般都需要重写以下方法：

int     getCount()            获取当前Adapter的Items数目

Object    getItem(int position)     获取相应position的Item

long    getItemId(int position)    获取相应position的Item在List中的row id

View    getView(int position, View convertView, ViewGroup parent) 获取在指定position所要显示的data的View

详细内容可以查看BaseAdapter类的继承android.widget.Adapter的方法，有时也需要重写ListAdapter的boolean         isEnabled(int position)来实现某些效果。

不同Adapter绑定数据的例子：

1.  使用ArrayAdapter

 

public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        //参考ArrayAdapter的构造函数
        setListAdapter(new ArrayAdapter<String>(this,
                        android.R.layout.simple_list_item_1,
                        mStrings));

        //在ListView上输入字母，就会自动筛选出以此内容开头的Item
        getListView().setTextFilterEnabled(true);
}

private String[] mStrings = {"A", "Android", "机器人", "Google"};

 

 

2. 使用SimpleCursorAdapter

  通过读取通讯录android.provider.Contacts.Phones的资料，显示出来。

 

protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // Get a cursor with all phones
        Cursor c = getContentResolver().query(Phones.CONTENT_URI, null, null, null, null);
        startManagingCursor(c);
        
        // Map Cursor columns to views defined in simple_list_item_2.xml
        ListAdapter adapter = new SimpleCursorAdapter(this,
                        android.R.layout.simple_list_item_2, c, 
                                        new String[] { Phones.NAME, Phones.NUMBER }, 
                                        new int[] { android.R.id.text1, android.R.id.text2 });
        setListAdapter(adapter);
}

 

3.  ListItem为单选按钮

 

public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        //参考ArrayAdapter的构造函数
        setListAdapter(new ArrayAdapter<String>(this,
                        android.R.layout.simple_list_item_single_choice,
                        mStrings));

        final ListView listView = getListView();
        listView.setItemsCanFocus(false);
        listView.setChoiceMode(ListView.CHOICE_MODE_SINGLE); //设置单选模式
}

private String[] mStrings = {"A", "Android", "机器人", "Google"};

 

 

4.  使用SimpleAdapter

   SimpleAdapter将一个List做为数据源，可以让ListView进行更加个性化的显示。而List中的第一项是个Map<String,?>(用到泛型)，其中Map中的每项将与ListView中的每项进行一一对应绑定。Ok，看一下构造：
   SimpleAdapter(Context context,List<? Extends Map<String,?>> data,int resource,String [] form, int [] to);
Context:当前上下文，一般把Activity.this传递进行。
Data: 数据源。
Resource: 自定义的layout模板资源，可以用 R.layout.xxx获取引用。
Form: 定义ListView中的每一项数据索引，索引来自于Map<String,?>，即指定要显示的内容。
To:View数组，在ListView模板中的定义View,与Form中需要一一对应。

public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

             List<Hashtable<String, Object>> listContent= newArrayList<Hashtable<String, Object>>();
      for (int i = 0; i < deviceList.size(); i++)
        {
         Hashtable<String, Object> table = new Hashtable<String, Object>();
            table.put("name", deviceList.get(i).Name);
         table.put("address", deviceList.get(i).Address);
             table.put("type", deviceList.get(i).Type + ""); 
         listContent.add(table);
        }
      adapter = new SimpleAdapter(HeartActivity.this,listContent, R.layout.child,new String[] { "name","address" }, new int[] {R.id.txtDeviceName, R.id.txtDeviceAddress });
      setListAdapter(adapter);
}

 

5. ListItem为多选按钮

把例子3的设置改为android.R.layout.simple_list_item_multiple_choice以及选择模式ListView.CHOICE_MODE_MULTIPLE。

更多的例子可以参考官方的Sample，在此列出相关List的示例说明：

List1 - 使用ArrayAdapter并setTextFilterEnabled(true)

List2 - 使用SimpleCursorAdapter读取通讯录People.NAME

List3 - 使用SimpleCursorAdapter读取通讯录Phones，两行显示Item

List4 - 使用自定义Adapter以及自定义ItemView

List5 - 带有separator的ListView，通过自定义Adapter，重写boolean isEnabled(int position)

List6 - 使用自定义Adapter以及自定义ItemView，可伸展隐藏内容

List7 - 使用SimpleCursorAdapter读取数据

List8 - 展现使用setEmptyView效果

List9 - 涉及OnScrollListener

List10 - ListItem为单选按钮

List11 - ListItem为多选按钮

List12 - 可以动态添加ListItem

List13 - 如何加快操作显示，during scrolls or flings的时候

List14 - 如何编写高效的List Adapter

其中List14，官方告诉我们：

To work efficiently the adapter implemented here uses two techniques:

 * - It reuses the convertView passed to getView() to avoid inflating View when it is not necessary

 * - It uses the ViewHolder pattern to avoid calling findViewById() when it is not necessary

还告诉了我们ViewHolder类的作用：

 * The ViewHolder pattern consists in storing a data structure in the tag of the view returned by

 * getView(). This data structures contains references to the views we want to bind data to, thus

 * avoiding calls to findViewById() every time getView() is invoked.

另外在以上的例子里面了解到，使用自定义Adapter，当数据发生变化后需要调用notifyDataSetChanged()来刷新ListView，但在List12的例子，使用ArrayAdapter却没有调用这方法，而随后自己写代码，在发生的异常里面了解到BaseAdapter，ArrayAdapter是会调用自己的notifyDataSetChanged()。

    ListView中的条目短按和长按事件，他们的处理方式是不同的。对于短按事件，处理起来比较简单，我们只需要覆盖ListActivity的onListItemClick()方法，如下所示：

    protected void onListItemClick(ListView arg0, View arg1, int arg2, long arg3) {
CharSequence s = ((TextView)arg1).getText();
Log.e("CallLogActivity",s+ " is clicked");
super.onListItemClick(arg0, arg1, arg2, arg3);   }
        对于长按事件，我们需要给listview注册一个OnItemLongClickListener，并实现Listener中定义的方法，如下所示：
getListView().setOnItemLongClickListener(new OnItemLongCLickListener(){
public boolean onItemLongClick(AdapterView parent, View view, int position,
long id) {
    Log.e("CallLogActivity", view.toString() + "position=" + position);
    CharSequence number = ((TextView) view).getText();
    Toast.makeText(this, number + " is long clicked",Toast.LENGTH_LONG).show();
    return true;    }      });