Android - An Open Handset Alliance Project

android.widget
public abstract class

android.widget.BaseExpandableListAdapter

java.lang.Object
	android.widget.BaseExpandableListAdapter	ExpandableListAdapter

Base class for a ExpandableListAdapter used to provide data and Views from some data to an expandable list view.

Adapters inheriting this class should verify that the base implementations of getCombinedChildId(long, long) and getCombinedGroupId(long) are correct in generating unique IDs from the group/children IDs.

Known Direct Subclasses

CursorTreeAdapter, SimpleExpandableListAdapter

Known Indirect Subclasses

ResourceCursorTreeAdapter, SimpleCursorTreeAdapter

Summary

Fields

protected final DataSetObservable mDataSetObservable

Public Constructors

BaseExpandableListAdapter()

Public Methods

				boolean	areAllItemsSelectable()
					Are all items in this ExpandableListAdapter selectable?
				long	getCombinedChildId(long groupId, long childId)
					Override this method if you foresee a clash in IDs based on this scheme: Base implementation returns a long: bit 0: Whether this ID points to a child (unset) or group (set), so for this method this bit will be 0.
				long	getCombinedGroupId(long groupId)
					Override this method if you foresee a clash in IDs based on this scheme: Base implementation returns a long: bit 0: Whether this ID points to a child (unset) or group (set), so for this method this bit will be 1.
				long	getNewSelectionForKey(long packedPosition, int keyCode, KeyEvent event)
					Given a keyboard key, let the adapter suggest the group/child to be made the new selected child.
				void	notifyDataSetChanged()

				void	notifyDataSetInvalidated()

				void	onGroupCollapsed(int groupPosition)
					Called when a group is being collapsed.
				void	onGroupExpanded(int groupPosition)
					Called when a group is being expanded.
				void	registerDataSetObserver(DataSetObserver observer)
					Register an observer that is called when changes happen to the data used by this adapter.
				void	unregisterDataSetObserver(DataSetObserver observer)
					Unregister an observer that has previously been registered with this adapter via registerDataSetObserver(DataSetObserver).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

	Object	clone()
		Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
	boolean	equals(Object o)
		Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	Class	getClass()
		Answers the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Answers an integer hash code for the receiver.
final	void	notify()
		Causes one thread which is `wait` ing on the receiver to be made ready to run.
final	void	notifyAll()
		Causes all threads which are `wait` ing on the receiver to be made ready to run.
	String	toString()
		Answers a string containing a concise, human-readable description of the receiver.
final	void	wait(long time, int frac)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait(long time)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait()
		Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

Methods inherited from interface android.widget.ExpandableListAdapter

				boolean	areAllItemsSelectable()
					Are all items in this ExpandableListAdapter selectable?
				Object	getChild(int groupPosition, int childPosition)
					Gets the data associated with the given child within the given group.
				long	getChildId(int groupPosition, int childPosition)
					Gets the ID for the given child within the given group.
				View	getChildView(int groupPosition, int childPosition, boolean isLastChild, View convertView, ViewGroup parent)
					Gets a View that displays the data for the given child within the given group.
				int	getChildrenCount(int groupPosition)
					Gets the number of children in a specified group.
				long	getCombinedChildId(long groupId, long childId)
					Gets an ID for a child that is unique across any item (either group or child) that is in this list.
				long	getCombinedGroupId(long groupId)
					Gets an ID for a group that is unique across any item (either group or child) that is in this list.
				Object	getGroup(int groupPosition)
					Gets the data associated with the given group.
				int	getGroupCount()
					Gets the number of groups.
				long	getGroupId(int groupPosition)
					Gets the ID for the group at the given position.
				View	getGroupView(int groupPosition, boolean isExpanded, View convertView, ViewGroup parent)
					Gets a View that displays the given group.
				long	getNewSelectionForKey(long packedPosition, int keyCode, KeyEvent event)
					Given a keyboard key, let the adapter suggest the group/child to be made the new selected child.
				boolean	isChildSelectable(int groupPosition, int childPosition)
					Whether the child at the specified position is selectable.
				void	onGroupCollapsed(int groupPosition)
					Called when a group is being collapsed.
				void	onGroupExpanded(int groupPosition)
					Called when a group is being expanded.
				void	registerDataSetObserver(DataSetObserver observer)
					Register an observer that is called when changes happen to the data used by this adapter.
				boolean	stableIds()
					Indicates whether the child and group IDs are stable across changes to the underlying data.
				void	unregisterDataSetObserver(DataSetObserver observer)
					Unregister an observer that has previously been registered with this adapter via registerDataSetObserver(DataSetObserver).

Details

Fields

protected final DataSetObservable mDataSetObservable

Public Constructors

public BaseExpandableListAdapter()

Public Methods

public boolean areAllItemsSelectable()

Are all items in this ExpandableListAdapter selectable?

public long getCombinedChildId(long groupId, long childId)

Override this method if you foresee a clash in IDs based on this scheme:

Base implementation returns a long:

bit 0: Whether this ID points to a child (unset) or group (set), so for this method this bit will be 0.

bit 1-31: Lower 31 bits of the groupId

bit 32-63: Lower 32 bits of the childId.

Gets an ID for a child that is unique across any item (either group or child) that is in this list. Expandable lists require each item (group or child) to have a unique ID among all children and groups in the list. This method is responsible for returning that unique ID given a child's ID and its group's ID. Furthermore, if stableIds() is true, the returned ID must be stable as well.

public long getCombinedGroupId(long groupId)

Override this method if you foresee a clash in IDs based on this scheme:

Base implementation returns a long:

bit 0: Whether this ID points to a child (unset) or group (set), so for this method this bit will be 1.

bit 1-31: Lower 31 bits of the groupId

bit 32-63: Lower 32 bits of the childId.

Gets an ID for a group that is unique across any item (either group or child) that is in this list. Expandable lists require each item (group or child) to have a unique ID among all children and groups in the list. This method is responsible for returning that unique ID given a group's ID. Furthermore, if stableIds() is true, the returned ID must be stable as well.

public long getNewSelectionForKey(long packedPosition, int keyCode, KeyEvent event)

Given a keyboard key, let the adapter suggest the group/child to be made the new selected child. Return PACKED_POSITION_VALUE_NULL to indicate no appropriate key (for example, the user pressed the back button, or a subclass does not support this feature) or for no preference.

public void notifyDataSetChanged()

public void notifyDataSetInvalidated()

public void onGroupCollapsed(int groupPosition)

Called when a group is being collapsed.

public void onGroupExpanded(int groupPosition)

Called when a group is being expanded.

public void registerDataSetObserver(DataSetObserver observer)

public void unregisterDataSetObserver(DataSetObserver observer)

Unregister an observer that has previously been registered with this adapter via registerDataSetObserver(DataSetObserver).

Android - An Open Handset Alliance Project

Documentation

Goodies

android.widget.BaseExpandableListAdapter

Known Direct Subclasses

Known Indirect Subclasses

See Also

Summary

Fields

Public Constructors

Public Methods

Methods inherited from class java.lang.Object

Methods inherited from interface android.widget.ExpandableListAdapter

Details

Fields

protected final DataSetObservable mDataSetObservable

Public Constructors

public BaseExpandableListAdapter()

Public Methods

public boolean areAllItemsSelectable()

public long getCombinedChildId(long groupId, long childId)

public long getCombinedGroupId(long groupId)

public long getNewSelectionForKey(long packedPosition, int keyCode, KeyEvent event)

public void notifyDataSetChanged()

See Also

public void notifyDataSetInvalidated()

See Also

public void onGroupCollapsed(int groupPosition)

public void onGroupExpanded(int groupPosition)

public void registerDataSetObserver(DataSetObserver observer)

public void unregisterDataSetObserver(DataSetObserver observer)

CursorTreeAdapter	An adapter that exposes data from a series of Cursors to an ExpandableListView widget.
SimpleExpandableListAdapter	An easy adapter to map static data to group and child views defined in an XML file.

ResourceCursorTreeAdapter	A fairly simple ExpandableListAdapter that creates views defined in an XML file.
SimpleCursorTreeAdapter	An easy adapter to map columns from a cursor to TextViews or ImageViews defined in an XML file.


e.g. "intent" or "activity"