Android API : SimpleCursorAdapter()

SimpleCursorAdapter() 是 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) {

        super(context, layout, c);

        mTo = to;

        mOriginalFrom = from;

        findColumns(from);

    }

參數：

Context context, 這個與 SimpleListItemFactory 相關的 ListView 所處運行上下文（context）。也就是這個 ListView 所在的 Activity。

int layout, 顯示 list item 的 布局文件。這個 layout 文件中至少要包含在 "to" 參數中命名的 views。

Cursor c, 數據庫的光標( Cursor )。如果 cursor 無效，則該參數可以為 null

String[] from, 指定 column 中的哪些列的數據將綁定（顯示）到 UI 中。如果 cursor 無效， 則該參數可為 null。

int[] to, 指定用於顯示 "from" 參數指定的數據列表的 views。 這些 views 必須都是 TextViews。 "from" 參數的前 N 個值（valus）和 "to" 參數的前 N 個 views 是一一對應的關系。如果 cursor 無效，則該參數可為 null。

示例：

Uri uri = Contacts.People.CONTENT_URI;

String[] projection = { Contacts.PeopleColumns.NAME,

        Contacts.PeopleColumns.NOTES };

String selection = Contacts.PeopleColumns.NAME + "=?";

String[] selectionArgs = { "Braincol","Nixn.dev" };

String sortOrder = Contacts.PeopleColumns.NAME;

 
//使用 managedQuery 獲取 Contacts.People 這個 ContentProvider 的 Cursor。

Cursor cursor = managedQuery(uri, projection, selection, selectionArgs,sortOrder);

    

//使用 SimpleCursorAdapter 建立 Cursor 的 Adapter 以便使用，數據表示形式為：NAME - NOTES

SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, R.layout.contact_list_item, 

              cursor, new String[] { ContactColumn.NAME,ContactColumn.NOTES }, 

              new int[] { R.id.name, R.id.notes });

 
//為當前ListView關聯Adapter

setListAdapter(adapter);