博客内容记录
场景
有时候，使用ListView并不能满足应用程序所需要的功能。有些应用程序需要多组ListView，这时候我们就要使用一种新的控件ExpandableListView——可以扩展的ListView。它的作用就是将ListView进行分组。就好像我们使用QQ的时候，有“我的好友”，“陌生人”，“黑名单”一样，点击一下会扩展开，再点击一下又会收缩回去。
ExpandableListView是一个垂直滚动显示两级列表项的视图，与ListView不同的是，它可以有两层：每一层都能够被独立的展开并显示其子项。这些子项来自于与该视图关联的ExpandableListAdapter。
每一个可以扩展的列表项的旁边都有一个指示符（箭头）用来说明该列表项目前的状态（这些状态一般是已经扩展开的列表项，还没有扩展开的列表项，子列表项和最后一个子列表项）。
- 可以使用方法：setChildIndicator(Drawable)，setGroupIndicator(Drawable)(或者相应的XML文件的属性) 去设置这些指示符的样式。当然也可以使用默认的指示符。
- 和android.R.layout.simple_expandable_list_item_1，android.R.layout.simple_expandable_list_item_2和ListView一样，ExpandableListView也是一个需要Adapter作为桥梁来取得数据的控件。一般适用于ExpandableListView的Adapter都要继承BaseExpandableListAdapter这个类，并且必须重载getGroupView和getChildView这两个最为重要的方法。
- BaseExpandableListAdapter的主要重载方法如下：
- public abstract ObjectgetChild (int groupPosition, int childPosition)
取得与指定分组、指定子项目关联的数据.
参数
groupPosition 包含子视图的分组的位置.
childPosition 指定的分组中的子视图的位置.
返回
与子视图关联的数据. - public abstract long getChildId (int groupPosition, intchildPosition)
取得给定分组中给定子视图的ID. 该组ID必须在组中是唯一的.必须不同于其他所有ID（分组及子项目的ID）.
参数
groupPosition 包含子视图的分组的位置.
childPosition 要取得ID的指定的分组中的子视图的位置.
返回
与子视图关联的ID. - public abstract View getChildView (int groupPosition, intchildPosition, boolean isLastChild, View convertView, ViewGroup parent)
取得显示给定分组给定子位置的数据用的视图.
参数
groupPosition 包含要取得子视图的分组位置.
childPosition 分组中子视图（要返回的视图）的位置.
isLastChild 该视图是否为组中的最后一个视图.
convertView 如果可能，重用旧的视图对象.使用前你应该保证视图对象为非空，并且是否是合适的类型.如果该对象不能转换为可以正确显示数据的视图，该方法就创建新视图.不保证使用先前由 getChildView(int, int,boolean, View, ViewGroup)创建的视图.
parent 该视图最终从属的父视图.
返回
指定位置相应的子视图. - public abstract int getChildrenCount (int groupPosition)
取得指定分组的子元素数.
参数
groupPosition 要取得子元素个数的分组位置.
返回
指定分组的子元素个数. - public abstract long getCombinedChildId (long groupId, long childId)
取得一览中可以唯一识别子条目的 ID（包括分组ID和子条目ID）.可扩展列表要求每个条目 （分组条目和子条目）具有一个可以唯一识别列表中子条目和分组条目的ID. 该方法根据给定子条目ID和分组条目ID返回唯一识别ID.另外，如果 hasStableIds() 为真，该函数返回的ID必须是固定不变的.
参数
groupId 包含子条目ID的分组条目ID.
childId 子条目的ID.
返回
可以在所有分组条目和子条目中唯一识别该子条目的ID（可能是固定不变的）. - public abstract long getCombinedGroupId (long groupId)
取得一览中可以唯一识别子条目的 ID（包括分组ID和子条目ID）.可扩展列表要求每个条目 （分组条目和子条目）具有一个可以唯一识别列表中子条目和分组条目的ID. 该方法根据给定子条目ID和分组条目ID返回唯一识别ID.另外，如果 hasStableIds() 为真，该函数返回的ID必须是固定不变的.
参数
groupId 分组条目ID.
返回
可以在所有分组条目和子条目中唯一识别该分组条目的ID（可能是固定不变的）. - public abstract Object getGroup (int groupPosition)
取得与给定分组关联的数据.
参数
groupPosition 分组的位置.
返回
指定分组的数据.
public abstract int getGroupCount ()
取得分组数.
返回
分组数. - public abstract long getGroupId (int groupPosition)
取得指定分组的ID.该组ID必须在组中是唯一的.必须不同于其他所有ID（分组及子项目的ID）.
参数
groupPosition 要取得ID的分组位置.
返回
与分组关联的ID. - public abstract View getGroupView (int groupPosition, booleanisExpanded, View convertView, ViewGroup parent)
取得用于显示给定分组的视图. 这个方法仅返回分组的视图对象， 要想获取子元素的视图对象，就需要调用 getChildView(int, int, boolean, View, ViewGroup).
参数
groupPosition 决定返回哪个视图的组位置 .
isExpanded 该组是展开状态还是收起状态 .
convertView 如果可能，重用旧的视图对象.使用前你应该保证视图对象为非空，并且是否是合适的类型.如果该对象不能转换为可以正确显示数据的视图，该方法就创建新视图.不保证使用先前由 getGroupView(int, boolean,View, ViewGroup)创建的视图.
parent 该视图最终从属的父视图.
返回
指定位置相应的组视图. - public abstract boolean hasStableIds ()
是否指定分组视图及其子视图的ID对应的后台数据改变也会保持该ID.
返回
是否相同的ID总是指向同一个对象. - public abstract boolean isChildSelectable (int groupPosition, intchildPosition)
指定位置的子视图是否可选择.
参数
groupPosition 包含要取得子视图的分组位置.
childPosition 分组中子视图的位置.
返回
是否子视图可选择.
- 优化扩展
这样就完成了一个最简单的ExpandableListView的控件。
在实际开发过程中，常常有不同的需求，比如每一个child需要不同的控件，每一个group或者child需要有图标，图标显示需要不一样，需要设置背景等各种各样能够让我们的程序变得美观的需求。那么下面就逐 一讨论一下ExpandableListView如何实现这些需求。
- 为ExpandableListView设置背景，并且默认展开第n组，n从0开始计数，则只需要添加如下代码：
1. myExpandableListView.setBackgroundResource(R.drawable.background);
2. myExpandableListView.expandGroup(0);
复制代码
则效果如下：
- 改变每个组前面的图标，并且图标样式随着合拢和展开不同，则只需要在res/drawable目录下定义文件：
Indicator.xml
<selector xmlns:android="http://schemas.android.com/apk/res/android">
<item android:state_expanded="true" android:drawable="@drawable/right" />
<item android:drawable="@drawable/down"></item>
</selector>
复制代码
- 在JAVA文件中添加：
myExpandableListView.setGroupIndicator(this.getResources().getDrawable(R.drawable.indicator));
复制代码
效果如下：
对于其他的属性设置，可以参考以下属性说明：
- android:childDivider
来分离子列表项的图片或者是颜色。注：图片不会完全显示，分离子列表项的是一条直线 - android:childIndicator
在子列表项旁边显示的指示符。注：可以是一个图片 - android:childIndicatorLeft
子列表项指示符的左边约束位置。注：即从左端0位置开始计数，比如，假设指示符是一个图标，给定这个属性值为3dip，则表示从左端起3dip开始显示此图标。 - android:childIndicatorRight
子列表项指示符的右边约束位置。注：表示右端到什么位置结束 - android:groupIndicator
在组列表项旁边显示的指示符。注：可以是一个图片。 - android:indicatorLeft
组列表项指示器的左边约束位置。注：表示左端从什么位置开始。 - android:indicatorRight
组列表项指示器的右边约束位置。注：表示右端到什么位置结束。
- 以疯狂android为例的基本用法介绍ExpandableListView其中几个重要的方法
- getGroupCount()
返回包含的组列表项的数量。
@Override
public int getGroupCount()
{
return armTypes.length;
}
- getGroup(int groupPosition)
返回组列表的数据
@Override
public Object getGroup(int groupPosition)
{
return armTypes[groupPosition];
}
- getGroupId(int groupPosition)
放回组列表组件的id
@Override
public long getGroupId(int groupPosition)
{
return groupPosition;
}
- getGroupView()
该方法将返回的View对象将作为组列表项
public View getGroupView(int groupPosition, boolean isExpanded,View convertView, ViewGroup parent)
{
LinearLayout ll = new LinearLayout(MainActivity.this);
ll.setOrientation(0);
ImageView logo = new ImageView(MainActivity.this);
logo.setImageResource(logos[groupPosition]);
ll.addView(logo);
TextView textView = getTextView();
textView.setText(getGroup(groupPosition).toString());
ll.addView(textView);
return ll;
}
- getChildCount()
该方法返回特定组所包含的子列表项的数量
@Override
public int getChildrenCount(int groupPosition)
{
return arms[groupPosition].length;
}
- getChildView()
该方法返回的View对象将作为特定组、特定位置的子列表项
public View getChildView(int groupPosition, int childPosition,
boolean isLastChild, View convertView, ViewGroup parent)
{
TextView textView = getTextView();
textView.setText(getChild(groupPosition, childPosition)
.toString());
return textView;
}
- getChildId（）
返回子列表组件的id
public long getChildId(int groupPosition, int childPosition)
{
return childPosition;
}
- getChild(int groupPosition, int childPosition)
返回子列表的数据
public Object getChild(int groupPosition, int childPosition)
{
return arms[groupPosition][childPosition];
}
@Override
public long getChildId(int groupPosition, int childPosition)
{
return childPosition;
}
isChildSelectable()
该方法返回true时，可以对子列表项设置监听监听函数
1、listView.setOnChildClickListener(）
监听子列表项按下事件
2、setOnGroupClickListener()
监听组列表项按下事件
疯狂android中代码文件
package org.crazyit.ui;
import android.app.Activity;
import android.os.Bundle;
import android.view.Gravity;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.view.ViewGroup;
import android.widget.AbsListView;
import android.widget.BaseExpandableListAdapter;
import android.widget.ExpandableListAdapter;
import android.widget.ExpandableListView;
import android.widget.ImageView;
import android.widget.LinearLayout;
import android.widget.TextView;
public class MainActivity extends Activity
{
@Override
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
//创建一个BaseExpandableListAdapter对象
ExpandableListAdapter adapter = new BaseExpandableListAdapter()
{
int[] logos = new int[]
{
R.drawable.p,
R.drawable.z,
R.drawable.t
};
private String[] armTypes = new String[]
{ "神族兵种", "虫族兵种", "人族兵种"};
private String[][] arms = new String[][]
{
{ "狂战士", "龙骑士", "黑暗圣堂", "电兵" },
{ "小狗", "刺蛇", "飞龙", "自爆飞机" },
{ "机枪兵", "护士MM" , "幽灵" }
};
// 获取指定组位置、指定子列表项处的子列表项数据
@Override
public Object getChild(int groupPosition, int childPosition)
{
return arms[groupPosition][childPosition];
}
@Override
public long getChildId(int groupPosition, int childPosition)
{
return childPosition;
}
@Override
public int getChildrenCount(int groupPosition)
{
return arms[groupPosition].length;
}
private TextView getTextView()
{
AbsListView.LayoutParams lp = new AbsListView.LayoutParams(
ViewGroup.LayoutParams.MATCH_PARENT, 64);
TextView textView = new TextView(MainActivity.this);
textView.setLayoutParams(lp);
textView.setGravity(Gravity.CENTER_VERTICAL | Gravity.LEFT);
textView.setPadding(36, 0, 0, 0);
textView.setTextSize(20);
return textView;
}
// 该方法决定每个子选项的外观
@Override
public View getChildView(int groupPosition, int childPosition,
boolean isLastChild, View convertView, ViewGroup parent)
{
TextView textView = getTextView();
textView.setText(getChild(groupPosition, childPosition)
.toString());
return textView;
}
// 获取指定组位置处的组数据
@Override
public Object getGroup(int groupPosition)
{
return armTypes[groupPosition];
}
@Override
public int getGroupCount()
{
return armTypes.length;
}
@Override
public long getGroupId(int groupPosition)
{
return groupPosition;
}
// 该方法决定每个组选项的外观
@Override
public View getGroupView(int groupPosition, boolean isExpanded,
View convertView, ViewGroup parent)
{
LinearLayout ll = new LinearLayout(MainActivity.this);
ll.setOrientation(0);
ImageView logo = new ImageView(MainActivity.this);
logo.setImageResource(logos[groupPosition]);
ll.addView(logo);
TextView textView = getTextView();
textView.setText(getGroup(groupPosition).toString());
ll.addView(textView);
return ll;
}
@Override
public boolean isChildSelectable(int groupPosition,
int childPosition)
{
return true;
}
@Override
public boolean hasStableIds()
{
return true;
}
};
ExpandableListView expandListView = (ExpandableListView) findViewById(R.id.list);
expandListView.setAdapter(adapter);
}
}