Skip to content

Most visited

Recently visited

navigation
Added in API level 1

GestureDetector.OnGestureListener

public static interface GestureDetector.OnGestureListener

android.view.GestureDetector.OnGestureListener
Known Indirect Subclasses


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.

Summary

Public methods

abstract boolean onDown(MotionEvent e)

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

abstract 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.

abstract void onLongPress(MotionEvent e)

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

abstract 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.

abstract void onShowPress(MotionEvent e)

The user has performed a down MotionEvent and not performed a move or up yet.

abstract boolean onSingleTapUp(MotionEvent e)

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

Public methods

onDown

Added in API level 1
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 MotionEvent: The down motion event.
Returns
boolean

onFling

Added in API level 1
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 MotionEvent: The first down motion event that started the fling.
e2 MotionEvent: The move motion event that triggered the current onFling.
velocityX float: The velocity of this fling measured in pixels per second along the x axis.
velocityY float: The velocity of this fling measured in pixels per second along the y axis.
Returns
boolean true if the event is consumed, else false

onLongPress

Added in API level 1
void onLongPress (MotionEvent e)

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

Parameters
e MotionEvent: The initial on down motion event that started the longpress.

onScroll

Added in API level 1
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 MotionEvent: The first down motion event that started the scrolling.
e2 MotionEvent: The move motion event that triggered the current onScroll.
distanceX float: 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 float: 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
boolean true if the event is consumed, else false

onShowPress

Added in API level 1
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 MotionEvent: The down motion event

onSingleTapUp

Added in API level 1
boolean onSingleTapUp (MotionEvent e)

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

Parameters
e MotionEvent: The up motion event that completed the first tap
Returns
boolean true if the event is consumed, else false
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.