de.mrapp.android.tabswitcher.layout.phone

Class PhoneDragTabsEventHandler

java.lang.Object

de.mrapp.android.tabswitcher.gesture.AbstractTouchEventHandler

de.mrapp.android.tabswitcher.layout.AbstractDragTabsEventHandler<PhoneDragTabsEventHandler.Callback>

de.mrapp.android.tabswitcher.layout.phone.PhoneDragTabsEventHandler

All Implemented Interfaces:

java.util.Comparator<AbstractTouchEventHandler>

public class PhoneDragTabsEventHandler
extends AbstractDragTabsEventHandler<PhoneDragTabsEventHandler.Callback>

A drag handler, which allows to calculate the position and state of tabs on touch events, when using the smartphone layout.

Since:

0.1.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	PhoneDragTabsEventHandler.Callback Defines the interface, a class, which should be notified about the events of a drag handler, must implement.

Nested classes/interfaces inherited from class de.mrapp.android.tabswitcher.layout.AbstractDragTabsEventHandler

AbstractDragTabsEventHandler.DragState

Field Summary

Fields inherited from class de.mrapp.android.tabswitcher.gesture.AbstractTouchEventHandler

MAX_PRIORITY, MIN_PRIORITY

Constructor Summary

Constructors

Constructor and Description
PhoneDragTabsEventHandler(TabSwitcher tabSwitcher, Arithmetics arithmetics, <any> viewRecycler) Creates a new drag handler, which allows to calculate the position and state of tabs on touch events, when using the smartphone layout.

Method Summary

Modifier and Type	Method and Description
protected AbstractItem	getFocusedItem(float position) The method, which is invoked on implementing subclasses in order to retrieve the item, which corresponds to the view, which is focused when clicking/dragging at a specific position.
protected boolean	isSwipeThresholdReached(TabItem swipedTabItem) Returns, whether the threshold of a swiped tab item, which causes the corresponding tab to be removed, has been reached, or not.
protected float	onOvershootEnd(float dragPosition, float overshootThreshold) The method, which is invoked on implementing subclasses, when the tabs are overshooting at the end.
protected void	onOvershootReverted() The method, which is invoked on implementing subclasses, when an overshoot has been reverted.
protected float	onOvershootStart(float dragPosition, float overshootThreshold) The method, which is invoked on implementing subclasses, when the tabs are overshooting at the start.
protected void	onReset() The method, which invoked on implementing subclasses, when the drag handler has been reset.

Methods inherited from class de.mrapp.android.tabswitcher.layout.AbstractDragTabsEventHandler

getArithmetics, getCallback, handleDrag, isDragging, isDraggingAllowed, onDown, onDrag, onTouchEvent, onUp, reset, setCallback, setDragState

Methods inherited from class de.mrapp.android.tabswitcher.gesture.AbstractTouchEventHandler

compare, equals, getDragHelper, getPriority, getTabSwitcher, getTouchableArea, getVelocityTracker, handleTouchEvent, hashCode, isInsideTouchableArea, isReset, setPointerId

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Comparator

comparing, comparing, comparingDouble, comparingInt, comparingLong, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

Constructor Detail

PhoneDragTabsEventHandler

public PhoneDragTabsEventHandler(TabSwitcher tabSwitcher,
                                 Arithmetics arithmetics,
                                 <any> viewRecycler)

Creates a new drag handler, which allows to calculate the position and state of tabs on touch events, when using the smartphone layout.

Parameters:

tabSwitcher - The tab switcher, whose tabs' positions and states should be calculated by the drag handler, as an instance of the class TabSwitcher. The tab switcher may not be null

arithmetics - The arithmetics, which should be used to calculate the position, size and rotation of tabs, as an instance of the type Arithmetics. The arithmetics may not be null

viewRecycler - The view recycler, which allows to inflate the views, which are used to visualize the tabs, whose positions and states should be calculated by the tab switcher, as an instance of the class AttachedViewRecycler. The view recycler may not be null

Method Detail

getFocusedItem

protected final AbstractItem getFocusedItem(float position)

Description copied from class: AbstractDragTabsEventHandler

The method, which is invoked on implementing subclasses in order to retrieve the item, which corresponds to the view, which is focused when clicking/dragging at a specific position.

Specified by:

getFocusedItem in class AbstractDragTabsEventHandler<PhoneDragTabsEventHandler.Callback>

Parameters:

position - The position on the dragging axis in pixels as a Float value

Returns:

The item, which corresponds to the focused view, as an instance of the class AbstractItem or null, if no view is focused

onOvershootStart

protected final float onOvershootStart(float dragPosition,
                                       float overshootThreshold)

Description copied from class: AbstractDragTabsEventHandler

The method, which is invoked on implementing subclasses, when the tabs are overshooting at the start.

Overrides:

onOvershootStart in class AbstractDragTabsEventHandler<PhoneDragTabsEventHandler.Callback>

Parameters:

dragPosition - The position of the pointer on the dragging axis in pixels as a Float value

overshootThreshold - The position on the dragging axis, an overshoot at the start currently starts at, in pixels as a Float value

Returns:

The updated position on the dragging axis, an overshoot at the start starts at, in pixels as a Float value

onOvershootEnd

protected final float onOvershootEnd(float dragPosition,
                                     float overshootThreshold)

Description copied from class: AbstractDragTabsEventHandler

The method, which is invoked on implementing subclasses, when the tabs are overshooting at the end.

Overrides:

onOvershootEnd in class AbstractDragTabsEventHandler<PhoneDragTabsEventHandler.Callback>

Parameters:

dragPosition - The position of the pointer on the dragging axis in pixels as a Float value

overshootThreshold - The position on the dragging axis, an overshoot at the end currently starts at, in pixels as a Float value

Returns:

The updated position on the dragging axis, an overshoot at the end starts at, in pixels as a Float value

onOvershootReverted

protected final void onOvershootReverted()

Description copied from class: AbstractDragTabsEventHandler

The method, which is invoked on implementing subclasses, when an overshoot has been reverted.

Overrides:

onOvershootReverted in class AbstractDragTabsEventHandler<PhoneDragTabsEventHandler.Callback>

onReset

protected final void onReset()

Description copied from class: AbstractDragTabsEventHandler

The method, which invoked on implementing subclasses, when the drag handler has been reset.

Overrides:

onReset in class AbstractDragTabsEventHandler<PhoneDragTabsEventHandler.Callback>

isSwipeThresholdReached

protected final boolean isSwipeThresholdReached(TabItem swipedTabItem)

Description copied from class: AbstractDragTabsEventHandler

Returns, whether the threshold of a swiped tab item, which causes the corresponding tab to be removed, has been reached, or not.

Overrides:

isSwipeThresholdReached in class AbstractDragTabsEventHandler<PhoneDragTabsEventHandler.Callback>

Parameters:

swipedTabItem - The swiped tab item as an instance of the class TabItem. The tab item may not be null

Returns:

True, if the threshold has been reached, false otherwise