com.telerik.widget.calendar

Class CalendarGestureManager

java.lang.Object

com.telerik.widget.calendar.CalendarGestureManager

All Implemented Interfaces:

GestureDetector.OnDoubleTapListener, GestureDetector.OnGestureListener, ScaleGestureDetector.OnScaleGestureListener

public class CalendarGestureManager
extends Object
implements GestureDetector.OnGestureListener, GestureDetector.OnDoubleTapListener, ScaleGestureDetector.OnScaleGestureListener

Used to handle gestures applied to the calendar view.

Constructor Summary

Constructors

Constructor and Description
CalendarGestureManager(RadCalendarView owner) Creates a new instance of the CalendarGestureManager class.

Method Summary

Modifier and Type	Method and Description
void	enableScroll() Used to enable the scrolling if it was previously disabled.
RadCalendarView.OnCellClickListener	getOnCellClickListener() Gets a listener that will be called when a cell is being pressed.
boolean	handleDoubleTap(MotionEvent event) Deprecated.
boolean	handleFling(float velocityX, float velocityY) Deprecated.
boolean	handleOnDown() Deprecated.
boolean	handleOnScale(ScaleGestureDetector scaleGestureDetector) Deprecated.
boolean	handleOnScaleBegin() Deprecated.
void	handleOnScaleEnd() Deprecated.
boolean	handleOnSingleTapUp() Deprecated.
boolean	handleScroll(float x, float y, float distanceX, float distanceY) Deprecated.
boolean	handleSingleTapConfirmed(MotionEvent event) Deprecated.
boolean	handleTouch(MotionEvent event) Handles the touch gesture.
boolean	isUsingDoubleTapToChangeDisplayMode() Gets a value which determines whether the display mode will be changed while the calendar is in month or year view and the detected gesture is double tap.
boolean	isUsingDragToMakeRangeSelection() Gets a value which determines whether the drag gesture will be used to select a rage of cells.
boolean	isUsingPinchCloseToChangeDisplayMode() Gets a value which determines whether the display mode will be changed while the calendar is in month view and the detected gesture is pinch close.
boolean	isUsingPinchOpenToChangeDisplayMode() Gets a value which determines whether the display mode will be changed while the calendar is in year view and the detected gesture is pinch open.
boolean	isUsingSwipeDownToChangeDisplayMode() Gets a value which determines whether the display mode will be changed while the calendar is in week view and the detected gesture is swipe down.
boolean	isUsingSwipeUpToChangeDisplayMode() Gets a value which determines whether the display mode will be changed while the calendar is in month view and the detected gesture is swipe up.
boolean	isUsingTapToChangeDisplayMode() Gets a value which determines whether the display mode will be changed while the calendar is in year view and the detected gesture is tap.
boolean	onDoubleTap(MotionEvent event)
boolean	onDoubleTapEvent(MotionEvent e)
boolean	onDown(MotionEvent event)
boolean	onFling(MotionEvent event1, MotionEvent event2, float velocityX, float velocityY)
void	onLongPress(MotionEvent e)
boolean	onScale(ScaleGestureDetector detector)
boolean	onScaleBegin(ScaleGestureDetector detector)
void	onScaleEnd(ScaleGestureDetector detector)
boolean	onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY)
void	onShowPress(MotionEvent e)
boolean	onSingleTapConfirmed(MotionEvent event)
boolean	onSingleTapUp(MotionEvent e)
void	setDoubleTapToChangeDisplayMode(boolean doubleTapToChangeDisplayMode) Sets a value which determines whether the display mode will be changed while the calendar is in month or year view and the detected gesture is double tap.
void	setOnCellClickListener(RadCalendarView.OnCellClickListener onCellClickListener) Sets a listener that will be called when a cell is being pressed.
void	setPinchCloseToChangeDisplayMode(boolean pinchCloseToChangeDisplayMode) Sets a value which determines whether the display mode will be changed while the calendar is in month view and the detected gesture is pinch close.
void	setPinchOpenToChangeDisplayMode(boolean pinchOpenToChangeDisplayMode) Sets a value which determines whether the display mode will be changed while the calendar is in year view and the detected gesture is pinch open.
void	setSwipeDownToChangeDisplayMode(boolean swipeDownToChangeDisplayMode) Sets a value which determines whether the display mode will be changed while the calendar is in week view and the detected gesture is swipe down.
void	setSwipeUpToChangeDisplayMode(boolean swipeUpToChangeDisplayMode) Sets a value which determines whether the display mode will be changed while the calendar is in month view and the detected gesture is swipe up.
void	setTapToChangeDisplayMode(boolean tapToChangeDisplayMode) Sets a value which determines whether the display mode will be changed while the calendar is in year view and the detected gesture is tap.
void	setUsingDragToMakeRangeSelection(boolean usingDragToMakeRangeSelection) Sets a value which determines whether the drag gesture will be used to select a rage of cells.
void	suspendScroll() Used to prevent the processing of the scrolling from the current manager instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

CalendarGestureManager

public CalendarGestureManager(RadCalendarView owner)

Creates a new instance of the CalendarGestureManager class.

Parameters:

owner - the calendar view instance owning the current gesture manager.

Method Detail

suspendScroll

public void suspendScroll()

Used to prevent the processing of the scrolling from the current manager instance.

See Also:

enableScroll()

enableScroll

public void enableScroll()

Used to enable the scrolling if it was previously disabled.

See Also:

suspendScroll()

isUsingPinchOpenToChangeDisplayMode

public boolean isUsingPinchOpenToChangeDisplayMode()

Gets a value which determines whether the display mode will be changed while the calendar is in year view and the detected gesture is pinch open. If the gesture is enabled the display mode will be changed to month.

Returns:

whether display mode is changed while in year view and the detected gesture is pinch open

setPinchOpenToChangeDisplayMode

public void setPinchOpenToChangeDisplayMode(boolean pinchOpenToChangeDisplayMode)

Sets a value which determines whether the display mode will be changed while the calendar is in year view and the detected gesture is pinch open. If the gesture is enabled the display mode will be changed to month.

Parameters:

pinchOpenToChangeDisplayMode - whether display mode is changed while in year view and the detected gesture is pinch open

isUsingPinchCloseToChangeDisplayMode

public boolean isUsingPinchCloseToChangeDisplayMode()

Gets a value which determines whether the display mode will be changed while the calendar is in month view and the detected gesture is pinch close. If the gesture is enabled the display mode will be changed to year.

Returns:

whether display mode is changed while in month view and the detected gesture is pinch close

setPinchCloseToChangeDisplayMode

public void setPinchCloseToChangeDisplayMode(boolean pinchCloseToChangeDisplayMode)

Sets a value which determines whether the display mode will be changed while the calendar is in month view and the detected gesture is pinch close. If the gesture is enabled the display mode will be changed to year.

Parameters:

pinchCloseToChangeDisplayMode - whether display mode is changed while in month view and the detected gesture is pinch close

isUsingSwipeDownToChangeDisplayMode

public boolean isUsingSwipeDownToChangeDisplayMode()

Gets a value which determines whether the display mode will be changed while the calendar is in week view and the detected gesture is swipe down. If the gesture is enabled the display mode will be changed to month.

Returns:

whether display mode is changed while in week view and the detected gesture swipe down

setSwipeDownToChangeDisplayMode

public void setSwipeDownToChangeDisplayMode(boolean swipeDownToChangeDisplayMode)

Sets a value which determines whether the display mode will be changed while the calendar is in week view and the detected gesture is swipe down. If the gesture is enabled the display mode will be changed to month.

Parameters:

swipeDownToChangeDisplayMode - whether display mode is changed while in week view and the detected gesture swipe down

isUsingSwipeUpToChangeDisplayMode

public boolean isUsingSwipeUpToChangeDisplayMode()

Gets a value which determines whether the display mode will be changed while the calendar is in month view and the detected gesture is swipe up. If the gesture is enabled the display mode will be changed to week.

Returns:

whether display mode is changed while in month view and the detected gesture is swipe up

setSwipeUpToChangeDisplayMode

public void setSwipeUpToChangeDisplayMode(boolean swipeUpToChangeDisplayMode)

Sets a value which determines whether the display mode will be changed while the calendar is in month view and the detected gesture is swipe up. If the gesture is enabled the display mode will be changed to week.

Parameters:

swipeUpToChangeDisplayMode - whether display mode is changed while in month view and the detected gesture is swipe up

isUsingTapToChangeDisplayMode

public boolean isUsingTapToChangeDisplayMode()

Gets a value which determines whether the display mode will be changed while the calendar is in year view and the detected gesture is tap. If the gesture is enabled the display mode will be changed to month and the display date will be changed so that the month that is tapped becomes visible.

Returns:

whether display mode is changed while in year view and the detected gesture is tap

setTapToChangeDisplayMode

public void setTapToChangeDisplayMode(boolean tapToChangeDisplayMode)

Sets a value which determines whether the display mode will be changed while the calendar is in year view and the detected gesture is tap. If the gesture is enabled the display mode will be changed to month and the display date will be changed so that the month that is tapped becomes visible.

Parameters:

tapToChangeDisplayMode - whether display mode is changed while in year view and the detected gesture is tap

isUsingDoubleTapToChangeDisplayMode

public boolean isUsingDoubleTapToChangeDisplayMode()

Gets a value which determines whether the display mode will be changed while the calendar is in month or year view and the detected gesture is double tap. If the gesture is enabled the display mode will be changed from year to month and the display date will be changed so that the month that is tapped becomes visible if the calendar is in year view. If it is in month view the display mode will be changed to year.

Returns:

whether display mode is changed while in month or year view and the detected gesture is double tap

setDoubleTapToChangeDisplayMode

public void setDoubleTapToChangeDisplayMode(boolean doubleTapToChangeDisplayMode)

Sets a value which determines whether the display mode will be changed while the calendar is in month or year view and the detected gesture is double tap. If the gesture is enabled the display mode will be changed from year to month and the display date will be changed so that the month that is tapped becomes visible if the calendar is in year view. If it is in month view the display mode will be changed to year.

Parameters:

doubleTapToChangeDisplayMode - whether display mode is changed while in month or year view and the detected gesture is double tap

isUsingDragToMakeRangeSelection

public boolean isUsingDragToMakeRangeSelection()

Gets a value which determines whether the drag gesture will be used to select a rage of cells. Once enabled this will prevent the scroll behavior and will enable range selection using a drag.

Returns:

true if drag for range selection is enabled, false otherwise.

setUsingDragToMakeRangeSelection

public void setUsingDragToMakeRangeSelection(boolean usingDragToMakeRangeSelection)

Sets a value which determines whether the drag gesture will be used to select a rage of cells. Once enabled this will prevent the scroll behavior and will enable range selection using a drag.

Parameters:

usingDragToMakeRangeSelection - the new drag state.

getOnCellClickListener

public RadCalendarView.OnCellClickListener getOnCellClickListener()

Gets a listener that will be called when a cell is being pressed.

Returns:

the current pressed cell listener.

setOnCellClickListener

public void setOnCellClickListener(RadCalendarView.OnCellClickListener onCellClickListener)

Sets a listener that will be called when a cell is being pressed.

Parameters:

onCellClickListener - the new pressed cell listener.

handleScroll

public boolean handleScroll(float x,
                            float y,
                            float distanceX,
                            float distanceY)

Deprecated.

Handles the scroll gesture using the passed parameters and responding according to the current display mode. Deprecated - the gesture manager is no longer being called from the calendar to manage gestures, but rather manages all gestures. Use the onScroll(android.view.MotionEvent, android.view.MotionEvent, float, float) method.

Parameters:

x - the current finger position along the x axis.

y - the current finger position along the y axis.

distanceX - the distance of the scroll along the x axis.

distanceY - the distance of the scroll along the y axis.

Returns:

true if the gesture was handled, false otherwise.

handleTouch

public boolean handleTouch(MotionEvent event)

Handles the touch gesture.

Parameters:

event - the event to be handled.

Returns:

true if the gesture was handled, false otherwise.

handleFling

public boolean handleFling(float velocityX,
                           float velocityY)

Deprecated.

Handles the fling gesture and applies the result by repeatedly invalidating the calendar view instance as needed. Deprecated - the gesture manager is no longer being called from the calendar to manage gestures, but rather manages all gestures. Use the onFling(android.view.MotionEvent, android.view.MotionEvent, float, float) method.

Parameters:

velocityX - the velocity produced by the gesture along the x axis.

velocityY - the velocity produced by the gesture along the y axis.

Returns:

true if the gesture was handled, false otherwise.

handleOnDown

public boolean handleOnDown()

Deprecated.

Handles the onDown event. Deprecated - the gesture manager is no longer being called from the calendar to manage gestures, but rather manages all gestures. Use the onDown(android.view.MotionEvent) method.

Returns:

true if the event was handled, false otherwise.

handleSingleTapConfirmed

public boolean handleSingleTapConfirmed(MotionEvent event)

Deprecated.

Handles the confirmed single tap gesture. Deprecated - the gesture manager is no longer being called from the calendar to manage gestures, but rather manages all gestures. Use the onSingleTapConfirmed(android.view.MotionEvent) method.

Parameters:

event - the event.

Returns:

true if the event was handled, false otherwise.

handleDoubleTap

public boolean handleDoubleTap(MotionEvent event)

Deprecated.

Handles the double tap gesture. Deprecated - the gesture manager is no longer being called from the calendar to manage gestures, but rather manages all gestures. Use the onDoubleTap(android.view.MotionEvent) method.

Parameters:

event - the event to be handled.

Returns:

true if the event was handled, false otherwise.

handleOnScaleBegin

public boolean handleOnScaleBegin()

Deprecated.

Handles the beginning of a shapeScale gesture. Deprecated - the gesture manager is no longer being called from the calendar to manage gestures, but rather manages all gestures. Use the onScaleBegin(android.view.ScaleGestureDetector) method.

Returns:

true if the gesture was handled, false otherwise.

handleOnScaleEnd

public void handleOnScaleEnd()

Deprecated.

Handles the end of a shapeScale gesture. Deprecated - the gesture manager is no longer being called from the calendar to manage gestures, but rather manages all gestures. Use the onScaleEnd(android.view.ScaleGestureDetector) method.

handleOnScale

public boolean handleOnScale(ScaleGestureDetector scaleGestureDetector)

Deprecated.

Handles the shapeScale gesture. Deprecated - the gesture manager is no longer being called from the calendar to manage gestures, but rather manages all gestures. Use the onScale(android.view.ScaleGestureDetector) method.

Parameters:

scaleGestureDetector - the shapeScale gesture detector to be used from which to take the current shapeScale factor.

Returns:

true if the gesture was handled, false otherwise.

handleOnSingleTapUp

public boolean handleOnSingleTapUp()

Deprecated.

Handles the single tap up gesture. Deprecated - the gesture manager is no longer being called from the calendar to manage gestures, but rather manages all gestures. Use the onSingleTapUp(android.view.MotionEvent) method.

Returns:

true if the gesture was handled, false otherwise.

onSingleTapConfirmed

public boolean onSingleTapConfirmed(MotionEvent event)

Specified by:

onSingleTapConfirmed in interface GestureDetector.OnDoubleTapListener

onDoubleTap

public boolean onDoubleTap(MotionEvent event)

Specified by:

onDoubleTap in interface GestureDetector.OnDoubleTapListener

onDoubleTapEvent

public boolean onDoubleTapEvent(MotionEvent e)

Specified by:

onDoubleTapEvent in interface GestureDetector.OnDoubleTapListener

onDown

public boolean onDown(MotionEvent event)

Specified by:

onDown in interface GestureDetector.OnGestureListener

onShowPress

public void onShowPress(MotionEvent e)

Specified by:

onShowPress in interface GestureDetector.OnGestureListener

onSingleTapUp

public boolean onSingleTapUp(MotionEvent e)

Specified by:

onSingleTapUp in interface GestureDetector.OnGestureListener

onScroll

public boolean onScroll(MotionEvent e1,
                        MotionEvent e2,
                        float distanceX,
                        float distanceY)

Specified by:

onScroll in interface GestureDetector.OnGestureListener

onLongPress

public void onLongPress(MotionEvent e)

Specified by:

onLongPress in interface GestureDetector.OnGestureListener

onFling

public boolean onFling(MotionEvent event1,
                       MotionEvent event2,
                       float velocityX,
                       float velocityY)

Specified by:

onFling in interface GestureDetector.OnGestureListener

onScale

public boolean onScale(ScaleGestureDetector detector)

Specified by:

onScale in interface ScaleGestureDetector.OnScaleGestureListener

onScaleBegin

public boolean onScaleBegin(ScaleGestureDetector detector)

Specified by:

onScaleBegin in interface ScaleGestureDetector.OnScaleGestureListener

onScaleEnd

public void onScaleEnd(ScaleGestureDetector detector)

Specified by:

onScaleEnd in interface ScaleGestureDetector.OnScaleGestureListener