ExpandableListView使用

博客内容记录

场景

有时候，使用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);
  }
}

posted @ 2017-10-17 08:43 Dyleaf 阅读(435) 评论(0) 编辑收藏举报

刷新页面返回顶部

Dyleaf

blog : http:www.dyleaf.cn

ExpandableListView使用

博客内容记录

场景

公告