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 |
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 | |
|---|---|
Public constructors
SimpleOnGestureListener
public SimpleOnGestureListener ()
Public methods
onContextClick
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
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
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
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
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
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
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
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
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
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 |