Added in API level 1

GestureDetector.SimpleOnGestureListener


public static class GestureDetector.SimpleOnGestureListener
extends Object implements GestureDetector.OnContextClickListener, GestureDetector.OnDoubleTapListener, GestureDetector.OnGestureListener

java.lang.Object
   ↳ android.view.GestureDetector.SimpleOnGestureListener


A convenience class to extend when you only want to listen for a subset of all the gestures. This implements all methods in the OnGestureListener, OnDoubleTapListener, and OnContextClickListener but does nothing and return false for all applicable methods.

Summary

Public constructors

SimpleOnGestureListener()

Public methods

boolean onContextClick(MotionEvent e)

Notified when a context click occurs.

boolean onDoubleTap(MotionEvent e)

Notified when a double-tap occurs.

boolean onDoubleTapEvent(MotionEvent e)

Notified when an event within a double-tap gesture occurs, including the down, move, and up events.

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 onSingleTapConfirmed(MotionEvent e)

Notified when a single-tap occurs.

boolean onSingleTapUp(MotionEvent e)

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

Inherited methods

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

abstract boolean onContextClick(MotionEvent e)

Notified when a context click occurs.

abstract boolean onDoubleTap(MotionEvent e)

Notified when a double-tap occurs.

abstract boolean onDoubleTapEvent(MotionEvent e)

Notified when an event within a double-tap gesture occurs, including the down, move, and up events.

abstract boolean onSingleTapConfirmed(MotionEvent e)

Notified when a single-tap occurs.

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 constructors

SimpleOnGestureListener

public SimpleOnGestureListener ()

Public methods

onContextClick

Added in API level 23
public boolean onContextClick (MotionEvent e)

Notified when a context click occurs.

Parameters
e MotionEvent: This value cannot be null.

Returns
boolean true if the event is consumed, else false

onDoubleTap

Added in API level 3
public boolean onDoubleTap (MotionEvent e)

Notified when a double-tap occurs. Triggered on the down event of second tap.

Parameters
e MotionEvent: This value cannot be null.

Returns
boolean true if the event is consumed, else false

onDoubleTapEvent

Added in API level 3
public boolean onDoubleTapEvent (MotionEvent e)

Notified when an event within a double-tap gesture occurs, including the down, move, and up events.

Parameters
e MotionEvent: This value cannot be null.

Returns
boolean true if the event is consumed, else false

onDown

Added in API level 1
public 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: This value cannot be null.

Returns
boolean

onFling

Added in API level 1
public 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: This value may be null.

e2 MotionEvent: This value cannot be null.

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
public void onLongPress (MotionEvent e)

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

Parameters
e MotionEvent: This value cannot be null.

onScroll

Added in API level 1
public 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: This value may be null.

e2 MotionEvent: This value cannot be null.

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
public 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: This value cannot be null.

onSingleTapConfirmed

Added in API level 3
public boolean onSingleTapConfirmed (MotionEvent e)

Notified when a single-tap occurs.

Unlike OnGestureListener.onSingleTapUp(MotionEvent), this will only be called after the detector is confident that the user's first tap is not followed by a second tap leading to a double-tap gesture.

Parameters
e MotionEvent: This value cannot be null.

Returns
boolean true if the event is consumed, else false

onSingleTapUp

Added in API level 1
public boolean onSingleTapUp (MotionEvent e)

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

Parameters
e MotionEvent: This value cannot be null.

Returns
boolean true if the event is consumed, else false