public
static
class
GestureDetector.SimpleOnGestureListener
extends Object
implements
GestureDetector.OnGestureListener,
GestureDetector.OnDoubleTapListener,
GestureDetector.OnContextClickListener
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
GestureDetector.OnGestureListener
, GestureDetector.OnDoubleTapListener
, and GestureDetector.OnContextClickListener
but does nothing and return false
for all applicable methods.
Public constructors | |
---|---|
GestureDetector.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 |
boolean
|
onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY)
Notified of a fling event when it occurs with the initial on down |
void
|
onLongPress(MotionEvent e)
Notified when a long press occurs with the initial on down |
boolean
|
onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY)
Notified when a scroll occurs with the initial on down |
void
|
onShowPress(MotionEvent e)
The user has performed a down |
boolean
|
onSingleTapConfirmed(MotionEvent e)
Notified when a single-tap occurs. |
boolean
|
onSingleTapUp(MotionEvent e)
Notified when a tap occurs with the up |
Inherited methods | |
---|---|
From
class
java.lang.Object
| |
From
interface
android.view.GestureDetector.OnGestureListener
| |
From
interface
android.view.GestureDetector.OnDoubleTapListener
| |
From
interface
android.view.GestureDetector.OnContextClickListener
|
GestureDetector.SimpleOnGestureListener ()
boolean onContextClick (MotionEvent e)
Notified when a context click occurs.
Parameters | |
---|---|
e |
MotionEvent :
The motion event that occurred during the context click. |
Returns | |
---|---|
boolean |
true if the event is consumed, else false |
boolean onDoubleTap (MotionEvent e)
Notified when a double-tap occurs.
Parameters | |
---|---|
e |
MotionEvent :
The down motion event of the first tap of the double-tap. |
Returns | |
---|---|
boolean |
true if the event is consumed, else false |
boolean onDoubleTapEvent (MotionEvent e)
Notified when an event within a double-tap gesture occurs, including the down, move, and up events.
Parameters | |
---|---|
e |
MotionEvent :
The motion event that occurred during the double-tap gesture. |
Returns | |
---|---|
boolean |
true if the event is consumed, else false |
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 |
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 |
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.
|
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 |
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
|
boolean onSingleTapConfirmed (MotionEvent e)
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 |
MotionEvent :
The down motion event of the single-tap. |
Returns | |
---|---|
boolean |
true if the event is consumed, else false |
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 |