Xamarin.Android之ListView和Adapter

一、前言

如今不管任何應用都能夠看到列表的存在，而本章我們將學習如何使用Xamarin去實現它，以及如何使用適配器和自定義適配器（本文中的適配器的主要內容就是將原始的數據轉換成了能夠供列表控件顯示的項）。

 

二、簡介適配器

在開始之前我們需要先了解下適配器，首先是提供給我們使用的適配器之間的關系：

下面我們將上面的適配器進行簡單的介紹：

BaseAdapter：顧名思義，就是所以適配器的基類，但是我們不能將其實例化，因為它是一個虛類，一般我們都是繼承該類並實現其中的方法，形成形成自定義的列表（大多數情況下我們都會使用到它）。

ArrayAdapter和ArrayAdapter<T>：就是專門用於將列表數據的適配器，該適配器內部已經實現了BaseAdapter的方法，所以我們只需要指定對應的數據項以及列表項資源即可。

CursorAdapter：上面的適配器只是用於列表數據，而該適配器則可以用在將數據庫返回的結果集顯示到列表中去，當然在難度上也要比上面的適配器高。

 

三、正文

 

1.簡單列表

下面我們將利用ListActivity和ArrayAdapater<T>去實現一個簡單的列表界面，下面為該示例的代碼（MainActivity.cs）：

    public class MainActivity : ListActivity
    {
        protected string[] items;

        protected override void OnCreate(Bundle bundle)
        {
            base.OnCreate(bundle);
            items = new string[]{
                "First","Second","Third"
            };
            ListAdapter = new ArrayAdapter<string>(this, Android.Resource.Layout.SimpleListItem1, items);
        }

        protected override void OnListItemClick(ListView l, View v, int position, long id)
        {
            var t = items[position];
            Toast.MakeText(this, t, ToastLength.Short).Show();
        }
}

這里有一個重要的關鍵詞就是ListActivity，如果存在一個界面整個界面都是列表，那么我們就可以繼承這個特殊的活動，並且可以通過ListView屬性和ListAdapter去控制，同時還可以響應關於列表的事件。其中我們利用了ArrayAdapter給列表指定了一個適配器，而這個適配器的第一個參數是當前的上下文，第二個是列表中的項的界面，最后一個就是對應的數據了。

 

最后將顯示如下的界面：

 

當我們點擊不同的項后，還能看到底部顯示了當前我們選擇的項。這個功能就是在我們重寫了OnListItemClick實現了，正如代碼中所示，我們根據position獲取指定的數據，然后通過Toast將其顯示出來。

 

 

2.自定義一個適配器

簡單介紹過如何使用適配器后，我們將開始學習如何利用BaseAdapter自定義一個適配器，能夠促使我們理解適配器內部的工作原理，首先我們來看下筆者的寫的代碼：

        public class MyCustomeAdapter : BaseAdapter<string>
        {
            string[] items;
            Activity activity;

            public MyCustomeAdapter(Activity context, string[] values)
                : base()
            {
                activity = context;
                items = values;
            }

            public override string this[int position]
            {
                get { return items[position]; }
            }

            public override int Count
            {
                get { return items.Length; }
            }

            public override long GetItemId(int position)
            {
                return position;
            }

            public override View GetView(int position, View convertView, ViewGroup parent)
            {
                View v = convertView;
                if (v == null)
                    v = activity.LayoutInflater.Inflate(Android.Resource.Layout.SimpleListItem1, null);
                v.FindViewById<TextView>(Android.Resource.Id.Text1).Text = items[position];
                return v;
            }
        }

其中最主要的是GetView方法，ListView和ListActivity主要是通過調用該方法獲取對應項的視圖，然后將其添加為子控件，從而顯示，如果我們需要顯示例如淘寶等app那種復雜的列表就需要通過重寫該方法達到，細心的讀者可以發現筆者是先判斷convertView是否為null，如果為null才通過Inflate方法重新實例化一個視圖，關於這部分我們可以參考該文章。

 

關於其他的方法相信大家靠名稱就能夠明白了，這里就不多做解釋，具體的使用方法如下所示：

        protected override void OnCreate(Bundle bundle)
        {
            base.OnCreate(bundle);
            string[] items = new string[]{
                "First","Second","Third"
            };
            ListAdapter = new MyCustomeAdapter(this, items);
        }

 

 

 

3.關鍵字索引

在手機的使用中，大家一定經常使用着電話簿，當我們點擊右邊的滾動條進行滑動的時候還會顯示a-z的字母並且列表的內容也會根據這些字母的變化發生變化，將快速定位到聯系人姓名為指定字母開頭的位置，本節我們將會學習如何實現該功能。

 

提供這個功能我們需要實現一個接口，這個接口就是ISectionIndexer，下面是關於該接口的代碼：

    public interface ISectionIndexer : IJavaObject, IDisposable
    {
        int GetPositionForSection(int section);
        int GetSectionForPosition(int position);
        Object[] GetSections();
    }

關於這些接口簡單的介紹下：

GetPositionForSection：根據關鍵字的索引獲取該關鍵字的起始數據索引。

GetSectionForPosition：根據數據索引獲取關鍵字索引。

GetSections：返回關鍵字數組。

 

筆者為了能夠節約時間，所以利用上節的示例代碼，在MyCustomeAdapter中實現了ISectionIndexer接口，下面是筆者的代碼：

public class MyCustomeAdapter : BaseAdapter<string> , ISectionIndexer
        {
            string[] items;
            Activity activity;

            Dictionary<string, int> alphaindex;
            Java.Lang.Object[] sectionsObjects;
            string[] sections;

            public MyCustomeAdapter(Activity context, string[] values)
                : base()
            {
                activity = context;
                items = values;

                alphaindex = new Dictionary<string, int>();
                //獲取每種關鍵字的起始數據索引
                for (int i = 0; i < items.Length; i++)
                {
                    string key = items[i][0].ToString();
                    if (!alphaindex.ContainsKey(key))
                        alphaindex.Add(key, i);
                }

                //將關鍵字轉換成數據
                sections = new string[alphaindex.Keys.Count];
                alphaindex.Keys.CopyTo(sections, 0);

                //將關鍵字轉換成Java.Lang.String類型
                sectionsObjects = new Java.Lang.Object[alphaindex.Keys.Count];
                for (int i = 0; i < sections.Length; i++)
                {
                    sectionsObjects[i] = new Java.Lang.String(sections[i]);
                }
            }

            public override string this[int position]
            {
                get { return items[position]; }
            }

            public override int Count
            {
                get { return items.Length; }
            }

            public override long GetItemId(int position)
            {
                return position;
            }

            public override View GetView(int position, View convertView, ViewGroup parent)
            {
                View v = convertView;
                if (v == null)
                    v = activity.LayoutInflater.Inflate(Android.Resource.Layout.SimpleListItem1, null);
                v.FindViewById<TextView>(Android.Resource.Id.Text1).Text = items[position];
                return v;
            }

            public int GetPositionForSection(int section)
            {
                //根據關鍵字索引獲取關鍵字，然后在根據關鍵字從alphaindex獲取對應的value，即該關鍵字的起始數據索引
                return alphaindex[sections[section]];
            }

            public int GetSectionForPosition(int position)
            {
                int preposition = 0;
                //循環關鍵字
                for (int i = 0; i < sections.Length; i++)
                {
                    //判斷當前的索引是否在i所在關鍵字的范圍內
                    if (GetPositionForSection(i) > position)
                        break;
                    preposition = i;
                }
                return preposition;
            }

            public Java.Lang.Object[] GetSections()
            {
                return sectionsObjects;
            }
        }

 

關於該接口方法中的實現可以看代碼中的注釋，在使用的時候也要寫如下代碼：

        protected override void OnCreate(Bundle bundle)
        {
            base.OnCreate(bundle);
            string[] items = new string[]{
                "Apple","As","Banner",
                "BMW","Beatf","Bad",
                "Day","Dazy","Eat","Else",
                "Feel","Fly","Go","Hourse"
            };
            ListAdapter = new MyCustomeAdapter(this, items);
            ListView.FastScrollEnabled = true;
            ListView.FastScrollAlwaysVisible = true;
        }

 

 

按照官方的說法其實只要將FastScrollEnabled設置為true即可，但是筆者在虛擬機中測試的時候並不會顯示，所以筆者還要再將FastScrollAlwaysVisible一起設置為true才可以看到效果，下面為筆者的虛擬機上的截圖：

 

 

4.Cursor列表

前面我們都是通過數組來填充列表的，但是實際情況下數據大多數都是來自於數據庫，而數據庫通過查詢后將會得到ICursor類型的返回值，當然我們也可以通過將ICursor轉換成數組或者鍵值對，但這些都是沒有必要的，因為有自帶的適配器（CursorAdapter）。

 

首先我們需要創建一個數據庫，下面是筆者的代碼，想學習數據庫的可以參考本人的以下隨筆：

《Xamarin.Android之SQLiteOpenHelper》

《Xamarin.Android之ContentProvider》

《Xamarin.Android之SQLite.NET ORM》

 

代碼如下所示：

    public class TestDatabase : SQLiteOpenHelper
    {
        public TestDatabase(Context context):base(context,"testdatabase.db",null,1)
        {}

        public override void OnCreate(SQLiteDatabase db)
        {
            db.ExecSQL("CREATE TABLE TestTable ( _id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL,name TEXT NOT NULL)");
            db.ExecSQL("INSERT INTO TestTable (name) values('Vegetables')");
            db.ExecSQL("INSERT INTO TestTable (name) values('Fruits')");
            db.ExecSQL("INSERT INTO TestTable (name) values('Flower Buds')");
            db.ExecSQL("INSERT INTO TestTable (name) values('Legumes')");
            db.ExecSQL("INSERT INTO TestTable (name) values('Bulbs')");
            db.ExecSQL("INSERT INTO TestTable (name) values('Tubers')");
        }

        public override void OnUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)
        {

        }
}

 

 

數據庫創建部分比較簡單，主要的重點是下面的代碼。我們將實例化SimpleCursorAdapter並賦值給ListAdapter中去，代碼如下所示：

    [Activity(Label = "CursorAdapter", MainLauncher = true, Icon = "@drawable/icon")]
    public class MainActivity : ListActivity
    {
        TestDatabase vdb;
        ICursor cursor;

        protected override void OnCreate(Bundle bundle)
        {
            base.OnCreate(bundle);
            vdb = new TestDatabase(this);
            //通過SQL查詢數據庫
            cursor = vdb.ReadableDatabase.RawQuery("SELECT * FROM TestTable", null);
            StartManagingCursor(cursor);
            //創建適配器
            ListAdapter = new SimpleCursorAdapter(this, Android.Resource.Layout.SimpleListItem1, cursor,
                new string[] { "name" },  //指定使用結果集中的哪個字段數據
                new int[] { Android.Resource.Id.Text1 }); //填充到哪個控件中
        }

        protected override void OnDestroy()
        {
            base.OnDestroy();
            StopManagingCursor(cursor);
            cursor.Close();
        }
}

通過上面的代碼我們可以看到SimpleCursorAdapter相比之前的適配器，需要的參數更多。同時還需要對Cursor這個重要資源進行管理，對應的可以看到StartManagingCursor和StopManagingCursor，希望讀者在實際開發中一定要注意資源的釋放，以上的結果筆者就不截圖了。

 

 

5.自定義CursorAdapter

為了某些效果我們不一定非要繼承BaseAdapter從而實現很多的方法，如果數據是來自於數據庫的我們還可以繼承自CursorAdapter，這樣我們能夠節省實現很多的方法，從而只需要關注重要部分，下面我們繼承CursorAdapter來查看需要實現哪些方法：

    public class CustomeCursorAdapter : Android.Widget.CursorAdapter
    {

        public override void BindView(Android.Views.View view, Android.Content.Context context, Android.Database.ICursor cursor)
        {
            throw new NotImplementedException();
        }

        public override Android.Views.View NewView(Android.Content.Context context, Android.Database.ICursor cursor, Android.Views.ViewGroup parent)
        {
            throw new NotImplementedException();
        }
}

可以看到我們只需要實現兩個方法，相比BaseAdapter而言減少了很多，其中BindView就是將ICursor中的數據與View進行綁定，而NewView則是創建所需的界面。下面我們自定一個適配器實現和上一節一樣的效果：

 

    public class CustomeCursorAdapter : Android.Widget.CursorAdapter
    {
        Activity context;

        public CustomeCursorAdapter(Activity context, ICursor cursor)
            : base(context, cursor)
        {
            this.context = context;
        }

        public override void BindView(Android.Views.View view, Android.Content.Context context, Android.Database.ICursor cursor)
        {
            TextView tv = view.FindViewById<TextView>(Android.Resource.Id.Text1);
            tv.Text = cursor.GetString(1);
        }

        public override Android.Views.View NewView(Android.Content.Context context, Android.Database.ICursor cursor, Android.Views.ViewGroup parent)
        {
            return this.context.LayoutInflater.Inflate(Android.Resource.Layout.SimpleListItem1, parent, false);
        }
}

 

 6.注意點

 需要讀者需要使用系統自帶的SimpleAdapter時，傳遞數據時候不能以Dictionary類型添加，必須以JavaDictionary，否則將會出現無法將其轉換為java.util.map的錯誤。