?
本文檔使用 PHP中文網(wǎng)手冊 發(fā)布
ExpandableListAdapter
翻譯時間：2011-1-25
版本：Android 3.0 r1
結(jié)構(gòu)
繼承關(guān)系
public interface ExpandableListAdapter
?
android.widget.ExpandableListAdapter
?
子類及間接子類
間接子類???????? BaseExpandableListAdapter,CursorTreeAdapter,ResourceCursorTreeAdapter, SimpleCursorTreeAdapter, SimpleExpandableListAdapter
?
類概述
這個適配器在ExpandableListView和底層數(shù)據(jù)之間起到了一個銜接的作用。該接口的實現(xiàn)類提供了訪問子元素（以組的形式將它們分類）的數(shù)據(jù)；同樣，也提供了為子元素和組創(chuàng)建相應(yīng)的視圖。
?
公共方法
?????? public abstract boolean areAllItemsEnabled ()
???????? ExpandableListAdapter里面的所有條目都可用嗎？如果是yes，就意味著所有條目可以選擇和點(diǎn)擊了。
返回值
??????????????????????????? 返回True表示所有條目均可用。
?????????????????? 參見
??????????????????????????? areAllItemsEnabled()
?
public abstract Cursor getChild (int groupPosition, int childPosition)
???????? 獲取指定組中的指定子元素數(shù)據(jù)。
???????? ???????? 參數(shù)
??????????????????????????? groupPosition?????????? 組位置（該組內(nèi)部含有子元素）
?????????????????? ???????? childPosition????????????? 子元素位置（相對于其它子元素）
???????? ???????? 返回值
??????????????????????????? 返回指定子元素數(shù)據(jù)。
?
public abstract long getChildId (int groupPosition, int childPosition)
獲取指定組中的指定子元素ID，這個ID在組里一定是唯一的。聯(lián)合ID（參見getCombinedChildId(long,
long)）在所有條目（所有組和所有元素）中也是唯一的。
?????????????????? 參數(shù)
??????????????????????????? groupPosition?????????? 組位置（該組內(nèi)部含有子元素）
?????????????????? ???????? childPosition????????????? 子元素位置（相對于其它子元素）
?????????????????? 返回值
???????? ???????? 子元素關(guān)聯(lián)ID。
?
???????? public abstract View getChildView (int groupPosition, int childPosition, boolean isLastChild, View convertView, ViewGroup parent)
???????? 獲取一個視圖對象，顯示指定組中的指定子元素數(shù)據(jù)。
???????? ???????? 參數(shù)
???????? ???????? ???????? groupPosition? ?組位置（該組內(nèi)部含有子元素）
?????????????????? ???????? childPosition? ??子元素位置（決定返回哪個視圖）
?????????????????? ???????? isLastChild? ???子元素是否處于組中的最后一個
convertView? ??重用已有的視圖(View)對象。注意：在使用前你應(yīng)該檢查一下這個視圖對象是否非空并且這個對象的類型是否合適。由此引伸出，如果該對象不能被轉(zhuǎn)換并顯示正確的數(shù)據(jù)，這個方法就會調(diào)用getChildView(int,
int, boolean, View, ViewGroup)來創(chuàng)建一個視圖(View)對象。
?????????????????? ???????? parent? ?????????? ??返回的視圖(View)對象始終依附于的視圖組。
???????? ???????? 返回值
???????? ?????????????????? 指定位置上的子元素返回的視圖對象
?
public abstract int getChildrenCount (int groupPosition)
???????? 獲取指定組中的子元素個數(shù)
?????????????????? 參數(shù)
??????????????????????????? groupPosition? 組位置（決定返回哪個組的子元素個數(shù)）
?????????????????? 返回值
??????????????????????????? 指定組的子元素個數(shù)
?
public abstract long getCombinedChildId (long groupId, long childId)
從列表所有項(組或子項)中獲得一個唯一的子ID號?？烧郫B列表要求每個元素(組或子項)在所有的子元素和組中有一個唯一的ID。本方法負(fù)責(zé)根據(jù)所給的子ID號和組ID號返回唯一的ID。此外，若hasStableIds()是true，那么必須要返回穩(wěn)定的ID。
?????????????????? 參數(shù)
??????????????????????????? groupId? 包含該子元素的組ID
??????????????????????????? childId? ?子元素的ID
返回值
列表所有項(組或子項)中唯一的(和可能穩(wěn)定)的子元素ID號。（譯者注：ID理論上是穩(wěn)定的，不會發(fā)生沖突的情況。也就是說，這個列表會有組、子元素，它們的ID都是唯一的。）
?
public abstract Cursor getGroup (int groupPosition)
獲取指定組中的數(shù)據(jù)
?????????????????? 參數(shù)
??????????????????????????? groupPosition? 組位置
?????????????????? 返回值
???????? ?????????????????? 返回組中的數(shù)據(jù)，也就是該組中的子元素數(shù)據(jù)。
?
public abstract int getGroupCount ()
???????? 獲取組的個數(shù)
?????????????????? 返回值
???????? ?????????????????? 組的個數(shù)
?
???????? public abstract long getGroupId (int groupPosition)
獲取指定組的ID，這個組ID必須是唯一的。聯(lián)合ID(參見getCombinedGroupId(long))在所有條目(所有組和所有元素)中也是唯一的。
?????????????????? 參數(shù)
??????????????????????????? groupPosition? 組位置
?????????????????? 返回值
??????????????????????????? 返回組相關(guān)ID
?
public abstract View getGroupView (int groupPosition, boolean isExpanded, View convertView, ViewGroup parent)
???????? 獲取顯示指定組的視圖對象。這個方法僅返回關(guān)于組的視圖對象，要想獲取子元素的視圖對象，就需要調(diào)用getChildView(int,
int, boolean, View, ViewGroup)。
???????? 參數(shù)
?????????????????? groupPosition? 組位置（決定返回哪個視圖）
?????????????????? isExpanded ???該組是展開狀態(tài)還是伸縮狀態(tài)
convertView? ?重用已有的視圖對象。注意：在使用前你應(yīng)該檢查一下這個視圖對象是否非空并且這個對象的類型是否合適。由此引伸出，如果該對象不能被轉(zhuǎn)換并顯示正確的數(shù)據(jù)，這個方法就會調(diào)用getGroupView(int,
boolean, View, ViewGroup)來創(chuàng)建一個視圖(View)對象。
?????????????????? parent? ?????????? 返回的視圖對象始終依附于的視圖組。
???????? 返回值
?????????????????? 返回指定組的視圖對象
?
???????? public abstract boolean hasStableIds ()
???????? 組和子元素是否持有穩(wěn)定的ID,也就是底層數(shù)據(jù)的改變不會影響到它們。
???????? 返回值
返回一個Boolean類型的值，如果為TRUE，意味著相同的ID永遠(yuǎn)引用相同的對象。
?
???????? public abstract boolean isChildSelectable (int groupPosition, int childPosition)
???????? 是否選中指定位置上的子元素。
?????????????????? 參數(shù)
??????????????????????????? groupPosition? 組位置（該組內(nèi)部含有這個子元素）
??????????????????????????? childPosition? ?子元素位置
?????????????????? 返回值
???????? ???????? 是否選中子元素
?
???????? public abstract boolean isEmpty ()
?????????????????? 返回值
如果當(dāng)前適配器不包含任何數(shù)據(jù)則返回True。經(jīng)常用來決定一個空視圖是否應(yīng)該被顯示。一個典型的實現(xiàn)將返回表達(dá)式getCount() == 0的結(jié)果，但是由于getCount()包含了頭部和尾部，適配器可能需要不同的行為。
???????? ???????? 參見
??????????????????????????? isEmpty()
?
???????? public abstract void onGroupCollapsed (int groupPosition)
???????? 當(dāng)組收縮狀態(tài)的時候此方法被調(diào)用。
?????????????????? 參數(shù)
??????????????????????????? groupPosition? 收縮狀態(tài)的組索引
?
???????? public abstract void onGroupExpanded (int groupPosition)
???????? 當(dāng)組展開狀態(tài)的時候此方法被調(diào)用。
?????????????????? 參數(shù)
??????????????????????????? groupPosition? 展開狀態(tài)的組位置
?
???????? public abstract void registerDataSetObserver (DataSetObserver observer)
???????? 注冊一個觀察者(observer)，當(dāng)此適配器數(shù)據(jù)修改時即調(diào)用此觀察者。
?????????????????? 參數(shù)
??????????????????????????? observer? 當(dāng)數(shù)據(jù)修改時通知調(diào)用的對象。
?
???????? public abstract void unregisterDataSetObserver (DataSetObserver observer)
取消先前通過registerDataSetObserver(DataSetObserver)方式注冊進(jìn)該適配器中的觀???????? 察者對象。
???????? ???????? 參數(shù)
??????????????????????????? observer? 取消這個觀察者的注冊
?
補(bǔ)充
???????? 文章精選
?????????????????? android 可展開（收縮）的列表ListView(ExpandableListView)
?????????????????? android CursorAdapter的監(jiān)聽事件