de.dimensionv.android.androfragments

Class ExpandableListFragment

java.lang.Object

android.support.v4.app.Fragment

de.dimensionv.android.androfragments.ExpandableListFragment

All Implemented Interfaces:

ComponentCallbacks, View.OnCreateContextMenuListener

public abstract class ExpandableListFragment
extends Fragment

A fragment that displays an expandable list of items by binding to a data source provided through the use of adapters, and exposes event handlers when the user selects an item.

ExpandableListFragment hosts a ExpandableListView object that can be bound to different data sources.

Binding to Data

You bind the ExpandableListFragment's ExpandableListView object to data using a class that implements the ExpandableListAdapter interface.

You must use ExpandableListFragment.setListAdapter() to associate the list with an adapter. Do not directly call ExpandableListView.setAdapter() or else important initialization will be skipped.

Since:

API 1.0.0

See Also:

setListAdapter(android.widget.ExpandableListAdapter), ExpandableListView

Nested Class Summary

Nested classes/interfaces inherited from class android.support.v4.app.Fragment

Fragment.InstantiationException, Fragment.SavedState

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	STATE_EXPANDED_GROUPS

Constructor Summary

Constructors

Constructor and Description
ExpandableListFragment()

Method Summary

Methods

Modifier and Type	Method and Description
void	expandGroups() Expand the groups that have been set to be expanded, in case it could not be done automatically during setting the expanded groups.
int[]	getExpandedGroups() Returns the positions of the currently expanded groups.
ExpandableListAdapter	getListAdapter() Get the ListAdapter associated with this activity's ListView.
ExpandableListView	getListView() Get the activity's list view widget.
long	getSelectedItemId() Get the cursor row ID of the currently selected list item.
int	getSelectedItemPosition() Get the position of the currently selected list item.
View	onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)
void	onDestroyView()
protected abstract boolean	onListChildClick(ExpandableListView parent, View view, int groupPosition, int childPosition, long id) This method will be called when a child item in the list is selected.
void	onResume()
void	onSaveInstanceState(Bundle outState)
void	onViewCreated(View view, Bundle savedInstanceState)
void	onViewStateRestored(Bundle savedInstanceState)
void	setEmptyText(CharSequence text) The default content for an ExpandableListFragment has a TextView that can be shown when the list is empty.
void	setExpandedGroups(int[] groupPositions) Sets the expanded groups.
void	setListAdapter(ExpandableListAdapter adapter) Provide the data binding for the list view.
void	setListShown(boolean shown) Control whether the list is being displayed.
void	setListShownNoAnimation(boolean shown) Like setListShown(boolean), but no animation is used when transitioning from the previous state.
void	setSelection(int position) Set the currently selected list item to the specified position with the adapter's data

Methods inherited from class android.support.v4.app.Fragment

dump, equals, getActivity, getAllowEnterTransitionOverlap, getAllowReturnTransitionOverlap, getArguments, getChildFragmentManager, getEnterTransition, getExitTransition, getFragmentManager, getId, getLayoutInflater, getLoaderManager, getParentFragment, getReenterTransition, getResources, getRetainInstance, getReturnTransition, getSharedElementEnterTransition, getSharedElementReturnTransition, getString, getString, getTag, getTargetFragment, getTargetRequestCode, getText, getUserVisibleHint, getView, hashCode, hasOptionsMenu, instantiate, instantiate, isAdded, isDetached, isHidden, isInLayout, isMenuVisible, isRemoving, isResumed, isVisible, onActivityCreated, onActivityResult, onAttach, onConfigurationChanged, onContextItemSelected, onCreate, onCreateAnimation, onCreateContextMenu, onCreateOptionsMenu, onDestroy, onDestroyOptionsMenu, onDetach, onHiddenChanged, onInflate, onLowMemory, onOptionsItemSelected, onOptionsMenuClosed, onPause, onPrepareOptionsMenu, onStart, onStop, registerForContextMenu, setAllowEnterTransitionOverlap, setAllowReturnTransitionOverlap, setArguments, setEnterSharedElementCallback, setEnterTransition, setExitSharedElementCallback, setExitTransition, setHasOptionsMenu, setInitialSavedState, setMenuVisibility, setReenterTransition, setRetainInstance, setReturnTransition, setSharedElementEnterTransition, setSharedElementReturnTransition, setTargetFragment, setUserVisibleHint, startActivity, startActivityForResult, toString, unregisterForContextMenu

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

STATE_EXPANDED_GROUPS

protected static final String STATE_EXPANDED_GROUPS

See Also:

Constant Field Values

Constructor Detail

ExpandableListFragment

public ExpandableListFragment()

Method Detail

onCreateView

public View onCreateView(LayoutInflater inflater,
                ViewGroup container,
                Bundle savedInstanceState)

Overrides:

onCreateView in class Fragment

Since:

Class 1.0, API 1.0.0

onViewCreated

public void onViewCreated(View view,
                 Bundle savedInstanceState)

Overrides:

onViewCreated in class Fragment

Since:

Class 1.0, API 1.0.0

onViewStateRestored

public void onViewStateRestored(Bundle savedInstanceState)

Overrides:

onViewStateRestored in class Fragment

Since:

Class 1.0, API 1.0.0

onResume

public void onResume()

Overrides:

onResume in class Fragment

Since:

Class 1.0, API 1.0.0

onSaveInstanceState

public void onSaveInstanceState(Bundle outState)

Overrides:

onSaveInstanceState in class Fragment

Since:

Class 1.0, API 1.0.0

onDestroyView

public void onDestroyView()

Overrides:

onDestroyView in class Fragment

Since:

Class 1.0, API 1.0.0

onListChildClick

protected abstract boolean onListChildClick(ExpandableListView parent,
                       View view,
                       int groupPosition,
                       int childPosition,
                       long id)

This method will be called when a child item in the list is selected. Subclasses have to override.

Parameters:

parent - The ExpandableListView that is hosting the child.

view - The View that represents the child in the list view.

groupPosition - the index of the group

childPosition - the index of the child

id - the ID of the child as returned by the adapter.

Returns:

true if even was handled, false if not.

Since:

Class 1.0, API 1.0.0

setListAdapter

public void setListAdapter(ExpandableListAdapter adapter)

Provide the data binding for the list view.

Parameters:

adapter - the ExpandableListAdapter binding the data to the view.

Since:

Class 1.0, API 1.0.0

setSelection

public void setSelection(int position)

Set the currently selected list item to the specified position with the adapter's data

Parameters:

position - the index of the item to select.

Since:

Class 1.0, API 1.0.0

getSelectedItemPosition

public int getSelectedItemPosition()

Get the position of the currently selected list item.

Returns:

the index of the cu

Since:

Class 1.0, API 1.0.0

getSelectedItemId

public long getSelectedItemId()

Get the cursor row ID of the currently selected list item.

Returns:

the selected item's row ID.

Since:

Class 1.0, API 1.0.0

getListView

public ExpandableListView getListView()

Get the activity's list view widget.

Returns:

the ExpandableListView of this fragment.

Since:

Class 1.0, API 1.0.0

setEmptyText

public void setEmptyText(CharSequence text)

The default content for an ExpandableListFragment has a TextView that can be shown when the list is empty. If you would like to have it shown, call this method to supply the text it should use.

Parameters:

text - The text to be shown when the list is empty.

Since:

Class 1.0, API 1.0.0

setListShown

public void setListShown(boolean shown)

Control whether the list is being displayed. You can make it not displayed if you are waiting for the initial data to show in it. During this time an indeterminant progress indicator will be shown instead.

Applications do not normally need to use this themselves. The default behavior of ListFragment is to start with the list not being shown, only showing it once an adapter is given with setListAdapter(ExpandableListAdapter). If the list at that point had not been shown, when it does get shown it will be do without the user ever seeing the hidden state.

Parameters:

shown - If true, the list view is shown; if false, the progress indicator. The initial value is true.

Since:

Class 1.0, API 1.0.0

setListShownNoAnimation

public void setListShownNoAnimation(boolean shown)

Like setListShown(boolean), but no animation is used when transitioning from the previous state.

Since:

Class 1.0, API 1.0.0

getListAdapter

public ExpandableListAdapter getListAdapter()

Get the ListAdapter associated with this activity's ListView.

Since:

Class 1.0, API 1.0.0

getExpandedGroups

public int[] getExpandedGroups()

Returns the positions of the currently expanded groups.

"Positions" means the index of the group within the used ExpandableListAdapter's underlying data structure.

Returns:

Array with the positions of the currently expanded groups.

Since:

Class 1.0, API 1.0.0

setExpandedGroups

public void setExpandedGroups(int[] groupPositions)

Sets the expanded groups. All group positions in the provided array will be expanded.

"Positions" means the index of the group within the used ExpandableListAdapter's underlying data structure.

Parameters:

groupPositions - Group positions to expand.

Since:

Class 1.0, API 1.0.0

expandGroups

public void expandGroups()

Expand the groups that have been set to be expanded, in case it could not be done automatically during setting the expanded groups.

In case the groups are already expanded, the method will simply return without doing anything.

Since:

Class 1.0, API 1.0.0