com.nhaarman.listviewanimations.itemmanipulation.expandablelistitem

Class ExpandableListItemAdapter<T>

java.lang.Object

android.widget.BaseAdapter

com.nhaarman.listviewanimations.ArrayAdapter<T>

com.nhaarman.listviewanimations.itemmanipulation.expandablelistitem.ExpandableListItemAdapter<T>

All Implemented Interfaces:

Adapter, ListAdapter, SpinnerAdapter, com.nhaarman.listviewanimations.util.Insertable<T>, com.nhaarman.listviewanimations.util.ListViewWrapperSetter, com.nhaarman.listviewanimations.util.Swappable

public abstract class ExpandableListItemAdapter<T>
extends com.nhaarman.listviewanimations.ArrayAdapter<T>
implements com.nhaarman.listviewanimations.util.ListViewWrapperSetter

An ArrayAdapter which allows items to be expanded using an animation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ExpandableListItemAdapter.ExpandCollapseListener

Field Summary

Fields inherited from interface android.widget.Adapter

IGNORE_ITEM_VIEW_TYPE, NO_SELECTION

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ExpandableListItemAdapter(Context context) Creates a new ExpandableListItemAdapter with an empty list.
protected	ExpandableListItemAdapter(Context context, int layoutResId, int titleParentResId, int contentParentResId) Creates a new ExpandableListItemAdapter with an empty list.
protected	ExpandableListItemAdapter(Context context, int layoutResId, int titleParentResId, int contentParentResId, List<T> items) Creates a new ExpandableListItemAdapter with the specified list, or an empty list if items == null.
protected	ExpandableListItemAdapter(Context context, List<T> items) Creates a new ExpandableListItemAdapter with the specified list, or an empty list if items == null.

Method Summary

Methods

Modifier and Type	Method and Description
void	collapse(int position) Collapse the view at given position.
void	expand(int position) Expand the view at given position.
View	getContentView(int position) Return the content view at the specified position.
abstract View	getContentView(int position, View convertView, ViewGroup parent) Get a View that displays the content of the data at the specified position in the data set.
View	getTitleView(int position) Return the title view at the specified position.
abstract View	getTitleView(int position, View convertView, ViewGroup parent) Get a View that displays the title of the data at the specified position in the data set.
View	getView(int position, View convertView, ViewGroup parent)
boolean	isExpanded(int position) Indicates if the item at the specified position is expanded.
void	notifyDataSetChanged()
void	setActionViewResId(int resId) Set the resource id of the child View contained in the View returned by getTitleView(int, android.view.View, android.view.ViewGroup) that will be the actuator of the expand / collapse animations. If there is no View in the title View with given resId, a NullPointerException is thrown.
void	setExpandCollapseListener(ExpandableListItemAdapter.ExpandCollapseListener expandCollapseListener) Set the ExpandableListItemAdapter.ExpandCollapseListener that should be notified of expand / collapse events.
void	setLimit(int limit) Set the maximum number of items allowed to be expanded.
void	setListViewWrapper(com.nhaarman.listviewanimations.util.ListViewWrapper listViewWrapper)
void	toggle(int position) Toggle the View at given position, ignores header or footer Views.

Methods inherited from class com.nhaarman.listviewanimations.ArrayAdapter

add, add, addAll, clear, contains, getCount, getItem, getItemId, getItems, propagateNotifyDataSetChanged, remove, remove, swapItems

Methods inherited from class android.widget.BaseAdapter

areAllItemsEnabled, getDropDownView, getItemViewType, getViewTypeCount, hasStableIds, isEmpty, isEnabled, notifyDataSetInvalidated, registerDataSetObserver, unregisterDataSetObserver

Methods inherited from class java.lang.Object

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

Constructor Detail

ExpandableListItemAdapter

protected ExpandableListItemAdapter(Context context)

Creates a new ExpandableListItemAdapter with an empty list.

ExpandableListItemAdapter

protected ExpandableListItemAdapter(Context context,
                         List<T> items)

Creates a new ExpandableListItemAdapter with the specified list, or an empty list if items == null.

ExpandableListItemAdapter

protected ExpandableListItemAdapter(Context context,
                         int layoutResId,
                         int titleParentResId,
                         int contentParentResId)

Creates a new ExpandableListItemAdapter with an empty list. Uses given layout resource for the view; titleParentResId and contentParentResId should be identifiers for ViewGroups within that layout.

ExpandableListItemAdapter

protected ExpandableListItemAdapter(Context context,
                         int layoutResId,
                         int titleParentResId,
                         int contentParentResId,
                         List<T> items)

Creates a new ExpandableListItemAdapter with the specified list, or an empty list if items == null. Uses given layout resource for the view; titleParentResId and contentParentResId should be identifiers for ViewGroups within that layout.

Method Detail

setListViewWrapper

public void setListViewWrapper(com.nhaarman.listviewanimations.util.ListViewWrapper listViewWrapper)

Specified by:

setListViewWrapper in interface com.nhaarman.listviewanimations.util.ListViewWrapperSetter

setActionViewResId

public void setActionViewResId(int resId)

Set the resource id of the child View contained in the View returned by getTitleView(int, android.view.View, android.view.ViewGroup) that will be the actuator of the expand / collapse animations.
If there is no View in the title View with given resId, a NullPointerException is thrown.

Default behavior: the whole title View acts as the actuator.

Parameters:

resId - the resource id.

setLimit

public void setLimit(int limit)

Set the maximum number of items allowed to be expanded. When the (limit+1)th item is expanded, the first expanded item will collapse.

Parameters:

limit - the maximum number of items allowed to be expanded. Use <= 0 for no limit.

setExpandCollapseListener

public void setExpandCollapseListener(ExpandableListItemAdapter.ExpandCollapseListener expandCollapseListener)

Set the ExpandableListItemAdapter.ExpandCollapseListener that should be notified of expand / collapse events.

getView

public View getView(int position,
           View convertView,
           ViewGroup parent)

Specified by:

getView in interface Adapter

getTitleView

public abstract View getTitleView(int position,
                View convertView,
                ViewGroup parent)

Get a View that displays the title of the data at the specified position in the data set. You can either create a View manually or inflate it from an XML layout file. When the View is inflated, the parent View (GridView, ListView...) will apply default layout parameters unless you use LayoutInflater.inflate(int, android.view.ViewGroup, boolean) to specify a root view and to prevent attachment to the root.

Parameters:

position - The position of the item within the adapter's data set of the item whose view we want.

convertView - The old view to reuse, if possible. Note: You should check that this view is non-null and of an appropriate type before using. If it is not possible to convert this view to display the correct data, this method can create a new view.

parent - The parent that this view will eventually be attached to

Returns:

A View corresponding to the title of the data at the specified position.

getContentView

public abstract View getContentView(int position,
                  View convertView,
                  ViewGroup parent)

Get a View that displays the content of the data at the specified position in the data set. You can either create a View manually or inflate it from an XML layout file. When the View is inflated, the parent View (GridView, ListView...) will apply default layout parameters unless you use LayoutInflater.inflate(int, android.view.ViewGroup, boolean) to specify a root view and to prevent attachment to the root.

Parameters:

position - The position of the item within the adapter's data set of the item whose view we want.

convertView - The old view to reuse, if possible. Note: You should check that this view is non-null and of an appropriate type before using. If it is not possible to convert this view to display the correct data, this method can create a new view.

parent - The parent that this view will eventually be attached to

Returns:

A View corresponding to the content of the data at the specified position.

isExpanded

public boolean isExpanded(int position)

Indicates if the item at the specified position is expanded.

Parameters:

position - Index of the view whose state we want.

Returns:

true if the view is expanded, false otherwise.

getTitleView

public View getTitleView(int position)

Return the title view at the specified position.

Parameters:

position - Index of the view we want.

Returns:

the view if it exist, null otherwise.

getContentView

public View getContentView(int position)

Return the content view at the specified position.

Parameters:

position - Index of the view we want.

Returns:

the view if it exist, null otherwise.

notifyDataSetChanged

public void notifyDataSetChanged()

Overrides:

notifyDataSetChanged in class com.nhaarman.listviewanimations.ArrayAdapter<T>

expand

public void expand(int position)

Expand the view at given position. Will do nothing if the view is already expanded.

Parameters:

position - the position to expand.

collapse

public void collapse(int position)

Collapse the view at given position. Will do nothing if the view is already collapsed.

Parameters:

position - the position to collapse.

toggle

public void toggle(int position)

Toggle the View at given position, ignores header or footer Views.

Parameters:

position - the position of the view to toggle.