Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public static class

GestureDetector.SimpleOnGestureListener

extends Object
implements GestureDetector.OnDoubleTapListener GestureDetector.OnGestureListener
java.lang.Object
   ↳ android.view.GestureDetector.SimpleOnGestureListener

Class Overview

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

Summary

Public Constructors
GestureDetector.SimpleOnGestureListener ()
Public Methods
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.
[Expand]
Inherited Methods
From class java.lang.Object
From interface android.view.GestureDetector.OnDoubleTapListener
From interface android.view.GestureDetector.OnGestureListener

Public Constructors

public GestureDetector.SimpleOnGestureListener ()

Added in API level 1

Public Methods

public boolean onDoubleTap ( MotionEvent e)

Added in API level 3

Notified when a double-tap occurs.

Parameters
e The down motion event of the first tap of the double-tap.
Returns
  • true if the event is consumed, else false

public boolean onDoubleTapEvent ( MotionEvent e)

Added in API level 3

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

Parameters
e The motion event that occurred during the double-tap gesture.
Returns
  • true if the event is consumed, else false

public boolean onDown ( MotionEvent e)

Added in API level 1

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.

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

Added in API level 1

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

public void onLongPress ( MotionEvent e)

Added in API level 1

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.

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

Added in API level 1

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

public void onShowPress ( MotionEvent e)

Added in API level 1

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

public boolean onSingleTapConfirmed ( MotionEvent e)

Added in API level 3

Notified when a single-tap occurs.

Unlike 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 The down motion event of the single-tap.
Returns
  • true if the event is consumed, else false

public boolean onSingleTapUp ( MotionEvent e)

Added in API level 1

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