added in API level 8

HeterogeneousExpandableList

public interface HeterogeneousExpandableList

android.widget.HeterogeneousExpandableList


Additional methods that when implemented make an ExpandableListAdapter take advantage of the Adapter view type mechanism.

An ExpandableListAdapter declares it has one view type for its group items and one view type for its child items. Although adapted for most ExpandableListViews, these values should be tuned for heterogeneous ExpandableListViews.

Lists that contain different types of group and/or child item views, should use an adapter that implements this interface. This way, the recycled views that will be provided to ExpandableListAdapter.getGroupView(int, boolean, View, ViewGroup) and ExpandableListAdapter.getChildView(int, int, boolean, View, ViewGroup) will be of the appropriate group or child type, resulting in a more efficient reuse of the previously created views.

Summary

Public methods

abstract int getChildType(int groupPosition, int childPosition)

Get the type of child View that will be created by ExpandableListAdapter.getChildView(int, int, boolean, View, ViewGroup) for the specified child item.

abstract int getChildTypeCount()

Returns the number of types of child Views that will be created by ExpandableListAdapter.getChildView(int, int, boolean, View, ViewGroup) .

abstract int getGroupType(int groupPosition)

Get the type of group View that will be created by ExpandableListAdapter.getGroupView(int, boolean, View, ViewGroup) .

abstract int getGroupTypeCount()

Returns the number of types of group Views that will be created by ExpandableListAdapter.getGroupView(int, boolean, View, ViewGroup) .

Public methods

getChildType

added in API level 8
public abstract int getChildType (int groupPosition, 
                int childPosition)

Get the type of child View that will be created by ExpandableListAdapter.getChildView(int, int, boolean, View, ViewGroup) for the specified child item.

Parameters
groupPosition int: the position of the group that the child resides in

childPosition int: the position of the child with respect to other children in the group

Returns
int An integer representing the type of child View. Two child views should share the same type if one can be converted to the other in ExpandableListAdapter.getChildView(int, int, boolean, View, ViewGroup) Note: Integers must be in the range 0 to getChildTypeCount() - 1. Adapter.IGNORE_ITEM_VIEW_TYPE can also be returned.

getChildTypeCount

added in API level 8
public abstract int getChildTypeCount ()

Returns the number of types of child Views that will be created by ExpandableListAdapter.getChildView(int, int, boolean, View, ViewGroup) . Each type represents a set of views that can be converted in ExpandableListAdapter.getChildView(int, int, boolean, View, ViewGroup) , for any group. If the adapter always returns the same type of View for all child items, this method should return 1.

This method will only be called when the adapter is set on the AdapterView.

Returns
int The total number of types of child Views that will be created by this adapter.

getGroupType

added in API level 8
public abstract int getGroupType (int groupPosition)

Get the type of group View that will be created by ExpandableListAdapter.getGroupView(int, boolean, View, ViewGroup) . for the specified group item.

Parameters
groupPosition int: the position of the group for which the type should be returned.

Returns
int An integer representing the type of group View. Two group views should share the same type if one can be converted to the other in ExpandableListAdapter.getGroupView(int, boolean, View, ViewGroup) . Note: Integers must be in the range 0 to getGroupTypeCount() - 1. Adapter.IGNORE_ITEM_VIEW_TYPE can also be returned.

getGroupTypeCount

added in API level 8
public abstract int getGroupTypeCount ()

Returns the number of types of group Views that will be created by ExpandableListAdapter.getGroupView(int, boolean, View, ViewGroup) . Each type represents a set of views that can be converted in ExpandableListAdapter.getGroupView(int, boolean, View, ViewGroup) . If the adapter always returns the same type of View for all group items, this method should return 1.

This method will only be called when the adapter is set on the AdapterView.

Returns
int The number of types of group Views that will be created by this adapter.