Android UI學習 - ListView

ListActivity

    ListActivity是一個專門顯示ListView的Activity類，它內置了ListView對象，只要我們設置了數據源，就會自動地顯示出來。

 

使用custom view for screen layout

     雖然ListActivity內置了ListView對象，但我們依然可以使用custom view，通過在onCreate()裡面調用setContentView(resources id)。

    不過要注意的是，在自定義的Layout裡面，要設置ListView對象的id為"@android:id/list"；在Java代碼裡使用android.R.id.list。

    下面的例子，通過添加一個id為android:empty的TextView，當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
}  

Row Layout

官方提供了多種ListItem的Layout (R.layout)，以下是較為常用的，更多的請查看API DOC的R.layout http://androidappdocs.appspot.com/reference/android/R.layout.html：

• 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引用就行了。可以參考http://androidappdocs.appspot.com/resources/tutorials/views/hello-listview.html。

 

綁定數據

    通過調用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)來實現某些效果。

    接下來看看幾個綁定數據的例子：

    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

    這是Sample裡面List3例子，通過讀取通訊錄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. 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()。可以查看後面的文章《有關Android線程的學習》裡面的例子！

  

ListView的事件響應

    通常我們響應ListItem的點擊事件：protected void onListItemClick(ListView l, View v, int position, long id) ，在此不詳細講了，理解該函數裡面的參數意義就行了。

本文出自 “學習Android” 博客，請務必保留此出處http://android.blog.51cto.com/268543/336162