android.view
Interface GestureDetector.OnGestureListener

All Known Implementing Classes:

Gallery, GestureDetector.SimpleOnGestureListener

Enclosing class:

GestureDetector

public static interface GestureDetector.OnGestureListener

The listener that is used to notify when gestures occur. If you want to listen for all the different gestures then implement this interface. If you only want to listen for a subset it might be easier to extend GestureDetector.SimpleOnGestureListener.

Method Summary

boolean	onDown(MotionEvent e) Notified when a tap occurs with the down MotionEvent that triggered it.
boolean	onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) Notified of a fling event when it occurs with the initial on down MotionEvent and the matching up MotionEvent.
void	onLongPress(MotionEvent e) Notified when a long press occurs with the initial on down MotionEvent that trigged it.
boolean	onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) Notified when a scroll occurs with the initial on down MotionEvent and the current move MotionEvent.
void	onShowPress(MotionEvent e) The user has performed a down MotionEvent and not performed a move or up yet.
boolean	onSingleTapUp(MotionEvent e) Notified when a tap occurs with the up MotionEvent that triggered it.

Method Detail

onDown

boolean onDown(MotionEvent e)

Notified when a tap occurs with the down MotionEvent that triggered it. This will be triggered immediately for every down event. All other events should be preceded by this.

Parameters:

e - The down motion event.

onShowPress

void onShowPress(MotionEvent e)

The user has performed a down MotionEvent and not performed a move or up yet. This event is commonly used to provide visual feedback to the user to let them know that their action has been recognized i.e. highlight an element.

Parameters:

e - The down motion event

onSingleTapUp

boolean onSingleTapUp(MotionEvent e)

Notified when a tap occurs with the up MotionEvent that triggered it.

Parameters:

e - The up motion event that completed the first tap

Returns:

true if the event is consumed, else false

onScroll

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

Notified when a scroll occurs with the initial on down MotionEvent and the current move MotionEvent. The distance in x and y is also supplied for convenience.

Parameters:

e1 - The first down motion event that started the scrolling.

e2 - The move motion event that triggered the current onScroll.

distanceX - The distance along the X axis that has been scrolled since the last call to onScroll. This is NOT the distance between e1 and e2.

distanceY - The distance along the Y axis that has been scrolled since the last call to onScroll. This is NOT the distance between e1 and e2.

Returns:

true if the event is consumed, else false

onLongPress

void onLongPress(MotionEvent e)

Notified when a long press occurs with the initial on down MotionEvent that trigged it.

Parameters:

e - The initial on down motion event that started the longpress.

onFling

boolean onFling(MotionEvent e1,
                MotionEvent e2,
                float velocityX,
                float velocityY)

Notified of a fling event when it occurs with the initial on down MotionEvent and the matching up MotionEvent. The calculated velocity is supplied along the x and y axis in pixels per second.

Parameters:

e1 - The first down motion event that started the fling.

e2 - The move motion event that triggered the current onFling.

velocityX - The velocity of this fling measured in pixels per second along the x axis.

velocityY - The velocity of this fling measured in pixels per second along the y axis.

Returns:

true if the event is consumed, else false