universum.studios.android.setting

Class SettingHeadersAdapter

java.lang.Object

<any>

universum.studios.android.setting.SettingHeadersAdapter

public class SettingHeadersAdapter
extends <any>

A SimpleAdapter implementation used to provide data set of Items for adapter view that displays a list of setting preferences in the context of SettingsBaseActivity.

This adapter uses the following view types to provide views for its data set of items:

• VIEW_TYPE_CATEGORY - view for the category header that has no fragment nor intent associated,
• VIEW_TYPE_CATEGORY_DIVIDER - view for divider between category headers,
• VIEW_TYPE_HEADER - view for the selectable header.

Data set of items with associated headers may be supplied via SettingHeadersAdapter(Context, List) constructor or changed via changeHeaders(List). The current data set of transformed items may be obtained via #getItems(). A specific item at a desired position may be obtained via #getItem(int) and its associated header via getItem(int).getHeader().

Author:

Martin Albedinsky

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SettingHeadersAdapter.CategoryDividerHolder A ViewHolder implementation for category divider view of SettingHeadersAdapter.
static class	SettingHeadersAdapter.CategoryHolder A ViewHolder implementation for category item view of SettingHeadersAdapter.
static class	SettingHeadersAdapter.HeaderHolder A ViewHolder implementation for header item view of SettingHeadersAdapter.
static class	SettingHeadersAdapter.Item Item class represents a data model for SettingHeadersAdapter.

Field Summary

Fields

Modifier and Type	Field and Description
static int	VIEW_TYPE_CATEGORY View type for the category item.
static int	VIEW_TYPE_CATEGORY_DIVIDER View type for the category divider.
static int	VIEW_TYPE_HEADER View type for the header item.

Constructor Summary

Constructors

Constructor and Description
SettingHeadersAdapter(android.content.Context context) Creates a new instance of SettingHeadersAdapter with empty data set.
SettingHeadersAdapter(android.content.Context context, List<android.preference.PreferenceActivity.Header> headers) Creates a new instance of SettingHeadersAdapter with the initial data set of headers.
SettingHeadersAdapter(android.content.Context context, android.preference.PreferenceActivity.Header[] headers) Same as SettingHeadersAdapter(Context, List) for array of headers.

Method Summary

Modifier and Type	Method and Description
void	changeHeaders(List<android.preference.PreferenceActivity.Header> headers) Same as swapHeaders(List) where the old headers are ignored.
void	changeItems(List<SettingHeadersAdapter.Item> items)
int	getItemViewType(int position)
int	getViewTypeCount()
boolean	hasStableIds()
boolean	isCategoryAt(int position) Checks whether item at the specified position is a category.
boolean	isCategoryDividerAt(int position) Checks whether item at the specified position is a category divider.
boolean	isEnabled(int position)
boolean	isHeaderAt(int position) Checks whether item at the specified position is a header.
protected void	onBindViewHolder(ViewHolder viewHolder, int position)
protected android.view.View	onCreateView(android.view.ViewGroup parent, int position)
protected ViewHolder	onCreateViewHolder(android.view.View itemView, int position)
void	setUseVectorIcons(boolean useVectorIcons) Sets a boolean flag indicating whether this adapter should treat icon parameter specified via PreferenceActivity.Header#iconRes as resource of vector drawable or as resource of standard drawable.
List<android.preference.PreferenceActivity.Header>	swapHeaders(List<android.preference.PreferenceActivity.Header> headers) Swaps the current data set of this adapter for the given headers.
List<SettingHeadersAdapter.Item>	swapItems(List<SettingHeadersAdapter.Item> items)

Methods inherited from class java.lang.Object

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

Field Detail

VIEW_TYPE_CATEGORY

public static final int VIEW_TYPE_CATEGORY

View type for the category item.

See Also:

Constant Field Values

VIEW_TYPE_CATEGORY_DIVIDER

public static final int VIEW_TYPE_CATEGORY_DIVIDER

View type for the category divider.

See Also:

Constant Field Values

VIEW_TYPE_HEADER

public static final int VIEW_TYPE_HEADER

View type for the header item.

This is only view type that is by default enabled by this adapter.

See Also:

isEnabled(int), Constant Field Values

Constructor Detail

SettingHeadersAdapter

public SettingHeadersAdapter(android.content.Context context)

Creates a new instance of SettingHeadersAdapter with empty data set.

See Also:

SimpleAdapter#SimpleAdapter(Context), SettingHeadersAdapter(Context, List)

SettingHeadersAdapter

public SettingHeadersAdapter(android.content.Context context,
                             android.preference.PreferenceActivity.Header[] headers)

Same as SettingHeadersAdapter(Context, List) for array of headers.

SettingHeadersAdapter

public SettingHeadersAdapter(android.content.Context context,
                             List<android.preference.PreferenceActivity.Header> headers)

Creates a new instance of SettingHeadersAdapter with the initial data set of headers.

Parameters:

context - Context in which will be the new adapter used.

headers - Initial data set of headers.

See Also:

changeHeaders(List), #getItems()

Method Detail

setUseVectorIcons

public void setUseVectorIcons(boolean useVectorIcons)

Sets a boolean flag indicating whether this adapter should treat icon parameter specified via PreferenceActivity.Header#iconRes as resource of vector drawable or as resource of standard drawable.

Parameters:

useVectorIcons - True to apply icon resources of items as vector drawables, false as standard drawables.

changeItems

public final void changeItems(List<SettingHeadersAdapter.Item> items)

Throws:

UnsupportedOperationException - Use changeHeaders(List) instead.

changeHeaders

public void changeHeaders(List<android.preference.PreferenceActivity.Header> headers)

Same as swapHeaders(List) where the old headers are ignored.

swapHeaders

public List<android.preference.PreferenceActivity.Header> swapHeaders(List<android.preference.PreferenceActivity.Header> headers)

Swaps the current data set of this adapter for the given headers.

Note, that as this adapter uses multiple view types to present its data set, the specified headers are transformed into data set of Items. The items data set may be obtained via #getItems() or a specific item at a desired position via #getItem(int). Header associated with an item at a specific position may be obtained via getItem(int).getHeader().

Parameters:

headers - The headers for which to create a new data set. May be null to clear the current data set.

See Also:

changeHeaders(List)

swapItems

public final List<SettingHeadersAdapter.Item> swapItems(List<SettingHeadersAdapter.Item> items)

Throws:

UnsupportedOperationException - Use swapHeaders(List) instead.

hasStableIds

public boolean hasStableIds()

getViewTypeCount

public int getViewTypeCount()

getItemViewType

public int getItemViewType(int position)

isEnabled

public boolean isEnabled(int position)

Returns:

True if item at the position is header, false otherwise.

See Also:

isHeaderAt(int)

isHeaderAt

public boolean isHeaderAt(int position)

Checks whether item at the specified position is a header.

Parameters:

position - The position of item to check.

Returns:

True if item at the position is header, false otherwise.

isCategoryAt

public boolean isCategoryAt(int position)

Checks whether item at the specified position is a category.

Parameters:

position - The position of item to check.

Returns:

True if item at the position is category, false otherwise.

See Also:

isHeaderAt(int), isCategoryDividerAt(int)

isCategoryDividerAt

public boolean isCategoryDividerAt(int position)

Checks whether item at the specified position is a category divider.

Parameters:

position - The position of item to check.

Returns:

True if item at the position is category divider, false otherwise.

See Also:

isCategoryAt(int)

onCreateView

protected android.view.View onCreateView(android.view.ViewGroup parent,
                                         int position)

onCreateViewHolder

protected ViewHolder onCreateViewHolder(android.view.View itemView,
                                        int position)

onBindViewHolder

protected void onBindViewHolder(ViewHolder viewHolder,
                                int position)