universum.studios.android.recycler.helper

Class RecyclerViewItemHelper.ItemInteractor

java.lang.Object

ItemTouchHelper.Callback

universum.studios.android.recycler.helper.RecyclerViewItemHelper.ItemInteractor

Direct Known Subclasses:

ItemDragHelper.Interactor, ItemSwipeHelper.Interactor

Enclosing class:

RecyclerViewItemHelper<I extends RecyclerViewItemHelper.ItemInteractor>

public abstract static class RecyclerViewItemHelper.ItemInteractor
extends ItemTouchHelper.Callback

A ItemTouchHelper.Callback implementation which should be used as base class for all interactors used by RecyclerViewItemHelper implementations.

Author:

Martin Albedinsky

Constructor Summary

Constructors

Constructor and Description
ItemInteractor()

Method Summary

Modifier and Type	Method and Description
protected abstract boolean	canAttachAdapter(RecyclerView.Adapter adapter) Called by the parent helper to check if the given adapter may be attached to this interactor instance.
abstract boolean	isActive() Returns boolean flag indicating whether this interactor is currently active.
boolean	isEnabled() Returns boolean flag indicating whether this interactor is enabled or not.
protected void	onAdapterAttached(RecyclerView.Adapter adapter) Invoked whenever a new adapter is attached to this interactor instance.
protected void	onAdapterDetached(RecyclerView.Adapter adapter) Invoked before a new adapter is attached to this interactor instance if there is already previous adapter attached.
protected void	onAttachedToHelper(RecyclerViewItemHelper helper) Invoked whenver attachToHelper(RecyclerViewItemHelper) is called for this interactor instance.
void	onChildDraw(android.graphics.Canvas canvas, RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dX, float dY, int actionState, boolean isCurrentlyActive)
void	onChildDrawOver(android.graphics.Canvas canvas, RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dX, float dY, int actionState, boolean isCurrentlyActive)
void	setEnabled(boolean enabled) Sets a boolean flag indicating whether this interactor should be enabled or not.
protected boolean	shouldHandleInteraction() Checks whether this interactor should handle interaction due to received callback from the parent helper.

Methods inherited from class java.lang.Object

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

Constructor Detail

ItemInteractor

public ItemInteractor()

Method Detail

onAttachedToHelper

protected void onAttachedToHelper(RecyclerViewItemHelper helper)

Invoked whenver attachToHelper(RecyclerViewItemHelper) is called for this interactor instance.

Parameters:

helper - The helper that will use this interactor to support its specific feature.

canAttachAdapter

protected abstract boolean canAttachAdapter(RecyclerView.Adapter adapter)

Called by the parent helper to check if the given adapter may be attached to this interactor instance.

If this method returns true, onAdapterAttached(RecyclerView.Adapter) will follow. If this interactor has attached any previous adapter, such adapter will be detached via onAdapterDetached(RecyclerView.Adapter) before the new one is attached.

Parameters:

adapter - The adapter to be checked if it may be attached.

Returns:

True if the parent helper may attach the adapter to this interactor, false otherwise.

onAdapterAttached

protected void onAdapterAttached(RecyclerView.Adapter adapter)

Invoked whenever a new adapter is attached to this interactor instance.

This method is called as result of call to RecyclerViewItemHelper.attachToRecyclerView(RecyclerView) for the parent helper.

Parameters:

adapter - The adapter of the associated RecyclerView to which is the parent helper attached.

See Also:

onAdapterDetached(RecyclerView.Adapter)

onAdapterDetached

protected void onAdapterDetached(RecyclerView.Adapter adapter)

Invoked before a new adapter is attached to this interactor instance if there is already previous adapter attached.

Parameters:

adapter - The previous adapter that has been detached from this interactor.

See Also:

onAdapterAttached(RecyclerView.Adapter)

setEnabled

public void setEnabled(boolean enabled)

Sets a boolean flag indicating whether this interactor should be enabled or not.

Parameters:

enabled - True to enable this interactor, false otherwise.

See Also:

isEnabled()

isEnabled

public boolean isEnabled()

Returns boolean flag indicating whether this interactor is enabled or not.

Returns:

True if this interactor is enabled, false otherwise.

See Also:

setEnabled(boolean)

isActive

public abstract boolean isActive()

Returns boolean flag indicating whether this interactor is currently active.

Returns:

True if this interactor performs some interaction logic at this time, false otherwise.

shouldHandleInteraction

protected boolean shouldHandleInteraction()

Checks whether this interactor should handle interaction due to received callback from the parent helper.

This implementation checks whether this interactor instance is enabled at this time and also has valid adapter attached. However inheritance hierarchies may override this behaviour as they desire.

Returns:

True if interaction should be handled, false otherwise.

onChildDraw

public void onChildDraw(android.graphics.Canvas canvas,
                        RecyclerView recyclerView,
                        RecyclerView.ViewHolder viewHolder,
                        float dX,
                        float dY,
                        int actionState,
                        boolean isCurrentlyActive)

onChildDrawOver

public void onChildDrawOver(android.graphics.Canvas canvas,
                            RecyclerView recyclerView,
                            RecyclerView.ViewHolder viewHolder,
                            float dX,
                            float dY,
                            int actionState,
                            boolean isCurrentlyActive)