因為Goolge有隻範例程式NotePad，所以目前的書籍很多都會用這個當例子
裡面會用到ListActivity這東西，今天我想探討其相關議題，包括如後自訂List的格式
他會使用到BaseAdapter這東西
說到ListActivity呢，就要先談及Activiry，Activity是Android四大支柱之一
他是代表一個顯示在手機上的"畫面"，每個程式都至少有一個Activity。
而ListActivity是從Actitivy延伸出去的，用來顯示列表。
但是已經有個ListView可以顯示列表了，為何還有個ListActivity，他跟ListView又有什麼不同
ListActivity簡單來說是一個包含ListView的Activity，他將ListView的功能從新包裝，扮演一個wrapper的角色，讓ListView更容易控制
ListActivity的部分原始碼
public class ListActivity extends Activity {
protected ListView mList;
private Handler mHandler = new Handler();
private boolean mFinishedStart = false;
.....
}
下面一個簡單的ListView範例
public class Note extends Activity {
String[] data=new String[]{"A","B","C"};
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
ListView list=(ListView)findViewById(R.id.ListView01);
ListAdapter ad=new ArrayAdapter (this,android.R.layout.simple_list_item_1,data);
list.setAdapter(ad);
list.setOnItemClickListener(new AdapterView.OnItemClickListener(){
@Override
public void onItemClick(AdapterView<?> arg0, View arg1, int arg2,long arg3) {
TextView txt=null;
txt=(TextView)arg0.getChildAt((int)arg3);
}});
}
在上面程式中可以用findViewById找出我在main.xml設定的ListView，好處是名子沒有被綁死，如果用ListActivity的話，佈置(layout)檔的ListView名子會被鎖定，上面設定Row用了佈局android.R.layout.simple_list_item_1，他跟R.layout不一樣，他是android.R.layout開頭，是Android提供的預設排版，懶惰的時候可以直接套Android提供的資源，除了layout之外他還有提供各種圖示，如果想寫一些通訊錄之類的，可以使用他提供的android.R.drawable.sym_call_incoming的圖示。
ListView想處裡按下事件的話是使用 AdapterView.OnItemClickListener，他提供的函式並不容易處裡閱讀，所以ListActivity提供了更好的界面
ListActivity一點簡單的程式
public class Note extends ListActivity {
/** Called when the activity is first created. */
String[] data=new String[]{"A","B","C"};
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.list);
getListView().setEmptyView(findViewById(R.id.empty));
Button b=(Button)findViewById(R.id.Button01);
b.setOnClickListener(new Button.OnClickListener(){
@Override
public void onClick(View v) {
fillData();
}});
}
private void fillData(){
ListAdapter ad=new ArrayAdapter(this,R.layout.notes_row,data);
setListAdapter(ad);
}
@Override
protected void onListItemClick(ListView l, View v, int position, long id) {
// TODO Auto-generated method stub
super.onListItemClick(l, v, position, id);
TextView txt=null;
txt=(TextView)l.getChildAt(position);
}
}
ListActivity的佈局檔，在此我取list，在ListActivity的佈局檔裡面最少要有一個ListView，而且名子必須是android:list，這是被綁死的，而且必須指定row的佈局，在此我用R.layout.notes_row，裡面只有一個TextView
<Listview android:id="@+id/android:list">
佈局檔
<?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:orientation="vertical"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
></ListView>
<TextView
android:id="@+id/empty"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="No Data"
/>
<Button android:text="Get" android:id="@+id/Button01" android:layout_width="wrap_content" android:layout_height="wrap_content"></Button>
</LinearLayout>
我們可以看一下ListActivity原始碼設局的部分
public void onContentChanged() {
super.onContentChanged();
View emptyView = findViewById(com.android.internal.R.id.empty);
mList = (ListView)findViewById(com.android.internal.R.id.list);
if (mList == null) {
throw new RuntimeException(
"Your content must have a ListView whose id attribute is " +
"'android.R.id.list'");
}
.....
}
如果ListActivity用的ListView名子不為android:list就會丟出RuntimeException的例外
ListActivity對於按下事件監聽是用
onListItemClick(ListView l, View v, int position, long id) ，這1比ListView提供的更好使用且更清晰，裡面幾個主要的參數ListView l，得到ListView主體。position是代表被按下item的編號，ListView預設是只有TextView，所以ListView看起來像是個TextView陣列，如果想自定義ListView的View必須自己寫一個類別繼承BaseAdapter
而最後一個參數id可以跟SQLite配合，他會回傳SQLite裡面的_id的值
SQLite的部分，請去參閱手冊，在Android裡面SQLite資料表配合CursorAdapter一定得有個名叫"_id"的主鍵，Android幾個有關Cursor的Adapter
- CursorAdapter
- ResourceCursorAdapter
- SimpleCursorAdapter
其中SimpleCursorAdapter繼承ResourceCursorAdapter，ResourceCursorAdapter又去繼承CursorAdapter。
而如果想要自定ListView的型態的話，必須寫個類別繼承
比方說帶著圖片的ListView
首先，先看一下一般書上都有的範例，或者到官方的網站也可以看到
http://developer.android.com/guide/samples/NotePad/index.html
private void fillData(){
Cursor c=mdb.fetchAll();
startManagingCursor(c);
c.moveToFirst();
String[] from=new String[]{mdb.KEY_NOTE};
int[] to =new int[]{R.id.text};
SimpleCursorAdapter ad=new SimpleCursorAdapter(this,R.layout.notes_row,c,from,to);
setListAdapter(ad);
}
fillData是把資料庫的東西填到ListView，一般都會用SimpleCursorAdapter去轉接，但是這不能滿足我們，所以我照自己的方式修改了一下
private void fillData(){
Cursor c=mdb.fetchAll();
startManagingCursor(c);
IconAdapter icad=new IconAdapter(this,c);
setListAdapter(icad);
}
寫一個帶著圖片的轉接器，來看一下IconAdapter 的程式碼
static class IconAdapter extends BaseAdapter{
private Context _ctx;
private ArrayList notes;
private LayoutInflater mlin;
private Bitmap icon;
private Cursor _c;
public IconAdapter(Context ctx,Cursor c){...}
，@Override
public int getCount() {...}
@Override
public Object getItem(int arg0) {...}
@Override
public long getItemId(int arg0) {...}
@Override
public View getView(int pos, View view, ViewGroup arg2) {...}
static class Holder{
TextView text;
ImageView icon;
}
}
BaseAdapter有四個函式要複寫getCount、getItem、getItemId、getView，而且不能亂寫
因為我是要從資料庫取資料，所以我用了Cursor當參數，用ArrayList存他，如果有買『旗標:Android程式設計與應用』的話，他裡面的例子是用靜態陣列當資料，但是那不能滿足我們需求
一步一步解析
建構式
public IconAdapter(Context ctx,Cursor c){
_ctx=ctx;
_c=c;
mlin=LayoutInflater.from(ctx);
notes=new ArrayList();
int index=0;
for(int i=0;i<c.getColumnCount();i++)
{
if(c.getColumnName(i).equals(NoteDbAdapter.KEY_NOTE))
{
index=i;
}
}
c.moveToFirst();
for(int i=0;i<c.getCount();i++)
{
notes.add(c.getString(index));
c.moveToNext();
}
icon=BitmapFactory.decodeResource(
_ctx.getResources(),android.R.drawable.sym_call_incoming);
}
裡面只是一般的設值，Cursor的操作請參考上一篇
http://hatsukiakio.blogspot.com/2009/06/cursorindexoutofboundsexception.html
而函式LayoutInflater.from(this)，這是要把佈局檔從xml file轉成Layout物件，這之後會用到
而要將資源轉成Bitmap則必須使用BitmapFactory.decodeResource(res,resID);
第一個參數可以用Context.getResources()取得，第二個是圖片ID，在此我們使用系統的來電圖示
getCount()
public int getCount() {
return notes.size();
}
要複寫函式之一，主要是這個ListView共有幾筆資料，我直接回傳ArrayList的size
getItem(int arg0)
public Object getItem(int arg0) {
return getView(arg0, null, null);
要複寫函式之二，回傳第arg0筆資料的物件，在此我交給getView去做
getItemId(int arg0)
@Override
public long getItemId(int arg0) {
if(_c!=null)
{
//重要
_c.moveToPosition(arg0);
return _c.getLong(0);
}
else{
return 0;
}
}
要複寫函式之三，這個函式很重要，如果要希望ListView能夠執行SQLite的執行刪除等動作，這個函式一定要寫對，因為onListItemClick(ListView l, View v, int position, long id)第四個參數id就是從這個函式來的，參考我們上面說的，想要對資料庫作動作須仰賴這個屬姓
之前因為沒寫好這個函式，導致程式雖然顯示正常，但是資料庫動作都錯掉了
一開始我們用一個變數Cursor _c儲存了傳進來的資料庫指標，先判斷他是不是null，不是的話用moveToPosition()移到指定位置把該row的"_id"欄位抓出來回傳，在此我的"_id"欄是在第0個位置(getItem跟getItemId傳進來的參數都是被點選row的position)
getView(int pos, View view, ViewGroup arg2)
@Override
public View getView(int pos, View view, ViewGroup arg2) {
Holder holder=null;
if(view==null)
{
view=mlin.inflate(R.layout.icon, null);
holder=new Holder();
holder.icon=(ImageView)view.findViewById(R.id.icon);
holder.text=(TextView)view.findViewById(R.id.icontext);
view.setTag(holder);
}
else{
holder=(Holder)view.getTag();
}
holder.text.setText(notes.get(pos));
holder.icon.setImageBitmap(icon);
return view;
}
要複寫函式之四，整個BaseAdapter最核心的函式，沒有他連顯示都辦不到
他會先傳近三個參數(第pos個row，第pos個row的View物件，Viewgroup)
我們真正會用到的只有前兩個
在看程式碼之前先看看R.layout.icon的佈局檔，裡面有一個ImageView、一個TextView
<?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="35sp"
android:layout_height="35sp"
></ImageView>
<TextView
android:id="@+id/icontext"
android:gravity="center_vertical"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_weight="1"
></TextView>
</LinearLayout>
而為了儲存這ImageView跟TextView，我宣告了一個資料結構
static class Holder{
TextView text;
ImageView icon;
}
一開始先宣告變數holder，然後看看現在這個位置的View是否產生過
如果沒有(view==null)，先讓View產生一個Layout佈局的物件，透過inflate函式可以把xml file的佈局檔轉成View物件
view=mlin.inflate(R.layout.icon, null);
之後就可以用findViewById取得佈局檔裡面的ImageView跟TextView，之後用setTag把Holder這資料結構儲存，以方便之後會再用到
holder=new Holder();
holder.icon=(ImageView)view.findViewById(R.id.icon);
holder.text=(TextView)view.findViewById(R.id.icontext);
view.setTag(holder);
如果View已經產生過了，就可以用getTag把之前儲存的Holder取出來
holder=(Holder)view.getTag();
之後把內容設定好後就可以回傳了
holder.text.setText(notes.get(pos));
holder.icon.setImageBitmap(icon);
return view;
-----------------------
這邊在提一下取用的方法
SimpleCursorAdapter ad=new SimpleCursorAdapter(this,R.layout.notes_row,c,from,to);
setListAdapter(ad);
...
protected void onListItemClick(ListView l, View v, int position, long id) {
super.onListItemClick(l, v, position, id);
TextView txt=(TextView)l.getChildAt(position);
...
}
}
在使用預設的SimpleCursorAdapter 時候，ListView的佈局只是一個TextView，可以直接用getChildAt(position)把內容抓出來
但是用了我們自己的IconAdapter的時候，要依據我們的佈局去抓，像是我用一個LinearLayout去包一個TextView，一個ImageView，所以用getChildAt(position)抓出來的是一個LinearLayout物件，要再去裡面抓想要的資料
IconAdapter icad=new IconAdapter(this,c);
setListAdapter(icad);
.........
protected void onListItemClick(ListView l, View v, int position, long id) {
super.onListItemClick(l, v, position, id);
LinearLayout lay=(LinearLayout)l.getChildAt(position);
TextView txt=(TextView)lay.findViewById(R.id.icontext);
.........
}
感謝2F的意見，下面是修改後的程式碼
上面錯誤的部分我就留者對照比較了
IconAdapter icad=new IconAdapter(this,c);
setListAdapter(icad);
.........
protected void onListItemClick(ListView l, View v, int position, long id) {
super.onListItemClick(l, v, position, id);
LinearLayout lay=(LinearLayout)l.getChildAt(position-l.getFirstVisiblePosition());
TextView txt=(TextView)lay.findViewById(R.id.icontext);
.........
}
