mva2.adapter

Class Section

java.lang.Object

mva2.adapter.Section

Direct Known Subclasses:

ItemSection, ListSection, NestedSection

public abstract class Section
extends java.lang.Object

Sections are the building blocks of the MultiViewAdapter.

Sections abstracts all the data related operations away from the adapter. You can add as many as sections to the adapter. All the updated to the section will correctly result in the proper notify method being called.

Similar to the MultiViewAdapter, 1. You can add decorators to section 2. Set SelectionMode, ExpansionMode and SectionExpansionMode 3. Set span count for the section.

The library has few implementation of Section classes which will help you in writing your own section implementation.

Constructor Summary

Constructors

Constructor and Description
Section()

Method Summary

Modifier and Type	Method and Description
void	addDecorator(Decorator decorator) Adds a decorator to the section.
void	addDecorator(Decorator decorator, int priority) Adds a decorator to the section with priority.
void	hideSection() Hide's the section inside the adapter.
boolean	isSectionHidden() Returns boolean flag indicating whether the section is hidden or not.
void	onChanged(int position, int count, java.lang.Object payload)
void	onInserted(int position, int count)
void	onMoved(int fromPosition, int toPosition)
void	onRemoved(int position, int count)
void	removeAllDecorators() Removes all the decorators added to this section.
boolean	removeDecorator(Decorator decorator) Removes the mentioned decorator from this section.
void	removeDecorator(int index) Removes the decorator at the specified index from this section.
void	setExpansionMode(Mode expansionMode) Set the expansion mode for this section.
void	setSectionExpansionMode(Mode sectionExpansionMode) Set the section expansion mode for this section.
void	setSelectionMode(Mode selectionMode) Set the selection mode for this section.
void	setSpanCount(int spanCount) Set the span count for this section.
void	showSection() If the section was hidden from parent, this method shows it again in the parent.

Methods inherited from class java.lang.Object

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

Constructor Detail

Section

public Section()

Method Detail

addDecorator

public void addDecorator(Decorator decorator)

Adds a decorator to the section. Decorators can affect both measurement and drawing of individual item views.

Decorators are ordered. Decorators placed earlier in the list will be run/queried/drawn first for their effects on item views. Padding added to views will be nested; a padding added by an earlier decorator will mean further decorator in the list will be asked to draw/pad within the previous decorator's given area.

Parameters:

decorator - Decorator to be added

addDecorator

public void addDecorator(Decorator decorator,
                         int priority)

Adds a decorator to the section with priority. Decorators can affect both measurement and drawing of individual item views.

Decorators are ordered. Decorators placed earlier in the list will be run/queried/drawn first for their effects on item views. Padding added to views will be nested; a padding added by an earlier decorator will mean further decorator in the list will be asked to draw/pad within the previous decorator's given area.

Parameters:

decorator - Decorator to be added

hideSection

public void hideSection()

Hide's the section inside the adapter. If the section is hidden, then the getCount() returns 0.

isSectionHidden

public boolean isSectionHidden()

Returns boolean flag indicating whether the section is hidden or not.

removeAllDecorators

public void removeAllDecorators()

Removes all the decorators added to this section.

removeDecorator

public boolean removeDecorator(Decorator decorator)

Removes the mentioned decorator from this section. If the decorator is not found, then this method returns silently.

Parameters:

decorator - Decorator to be removed.

Returns:

boolean flag which indicated whether the decorator was removed or not.

removeDecorator

public void removeDecorator(int index)

Removes the decorator at the specified index from this section. If the decorator is not found, then this method returns silently.

Parameters:

index - index of the decorator to be removed.

setExpansionMode

public void setExpansionMode(Mode expansionMode)

Set the expansion mode for this section. Default the expansion mode is Mode.INHERIT. If the value is set then it overrides the parent's expansion mode.

Parameters:

expansionMode - Mode to be set for this section's expansion mode

setSectionExpansionMode

public void setSectionExpansionMode(Mode sectionExpansionMode)

Set the section expansion mode for this section. Default the section expansion mode is Mode.INHERIT. If the value is set then it overrides the parent's section expansion mode.

Parameters:

sectionExpansionMode - Mode to be set for this section's section expansion mode

setSelectionMode

public void setSelectionMode(Mode selectionMode)

Set the selection mode for this section. Default the selection mode is Mode.INHERIT. If the value is set then it overrides the parent's selection mode.

Parameters:

selectionMode - Mode to be set for this section's selection mode

setSpanCount

public void setSpanCount(int spanCount)

Set the span count for this section. The span count of the section will used along with its parent's span count to calculate the maxSpanCount which is used in ItemBinder.getSpanSize(int).

For example,

• Parent's span count is 6.
• Section's span count is 3.

Then, maxSpanCount sent in ItemBinder.getSpanSize(int) is 3. Span count for each item will be multiplied by 2 (ParentSpanCount / SectionSpanCount). Lets assume that each item inside the section returns span count as 1. Then, inside parent each will be considered as 1 * 2 = 2.

As a best practice, set the spanCount for parent as multiple of the section's spanCount.

Parameters:

spanCount - Count to be set as span count

showSection

public void showSection()

If the section was hidden from parent, this method shows it again in the parent.

onInserted

public final void onInserted(int position,
                             int count)

onRemoved

public final void onRemoved(int position,
                            int count)

onMoved

public final void onMoved(int fromPosition,
                          int toPosition)

onChanged

public final void onChanged(int position,
                            int count,
                            java.lang.Object payload)