# Print output for @column tags ?>
public
class
GestureDetector
extends Object
java.lang.Object | |
↳ | android.view.GestureDetector |
Detects various gestures and events using the supplied MotionEvent
s.
The OnGestureListener
callback will notify users when a particular
motion event has occurred. This class should only be used with MotionEvent
s
reported via touch (don't use for trackball events).
To use this class:
GestureDetector
for your View
View#onTouchEvent(MotionEvent)
method ensure you call
onTouchEvent(android.view.MotionEvent)
. The methods defined in your callback
will be executed when the events occur.
OnContextClickListener#onContextClick(MotionEvent)
you must call onGenericMotionEvent(android.view.MotionEvent)
in View#onGenericMotionEvent(MotionEvent)
.
Nested classes | |
---|---|
interface |
GestureDetector.OnContextClickListener
The listener that is used to notify when a context click occurs. |
interface |
GestureDetector.OnDoubleTapListener
The listener that is used to notify when a double-tap or a confirmed single-tap occur. |
interface |
GestureDetector.OnGestureListener
The listener that is used to notify when gestures occur. |
class |
GestureDetector.SimpleOnGestureListener
A convenience class to extend when you only want to listen for a subset of all the gestures. |
Public constructors | |
---|---|
GestureDetector(GestureDetector.OnGestureListener listener, Handler handler)
This constructor is deprecated.
Use |
|
GestureDetector(GestureDetector.OnGestureListener listener)
This constructor is deprecated.
Use |
|
GestureDetector(Context context, GestureDetector.OnGestureListener listener)
Creates a GestureDetector with the supplied listener. |
|
GestureDetector(Context context, GestureDetector.OnGestureListener listener, Handler handler)
Creates a GestureDetector with the supplied listener that runs deferred events on the
thread associated with the supplied |
|
GestureDetector(Context context, GestureDetector.OnGestureListener listener, Handler handler, boolean unused)
Creates a GestureDetector with the supplied listener that runs deferred events on the
thread associated with the supplied |
Public methods | |
---|---|
boolean
|
isLongpressEnabled()
|
boolean
|
onGenericMotionEvent(MotionEvent ev)
Analyzes the given generic motion event and if applicable triggers the
appropriate callbacks on the |
boolean
|
onTouchEvent(MotionEvent ev)
Analyzes the given motion event and if applicable triggers the
appropriate callbacks on the |
void
|
setContextClickListener(GestureDetector.OnContextClickListener onContextClickListener)
Sets the listener which will be called for context clicks. |
void
|
setIsLongpressEnabled(boolean isLongpressEnabled)
Set whether longpress is enabled, if this is enabled when a user presses and holds down you get a longpress event and nothing further. |
void
|
setOnDoubleTapListener(GestureDetector.OnDoubleTapListener onDoubleTapListener)
Sets the listener which will be called for double-tap and related gestures. |
Inherited methods | |
---|---|
public GestureDetector (GestureDetector.OnGestureListener listener, Handler handler)
This constructor is deprecated.
Use GestureDetector(android.content.Context, android.view.GestureDetector.OnGestureListener, android.os.Handler)
instead.
Creates a GestureDetector with the supplied listener. This variant of the constructor should be used from a non-UI thread (as it allows specifying the Handler).
Parameters | |
---|---|
listener |
GestureDetector.OnGestureListener : the listener invoked for all the callbacks, this must
not be null. |
handler |
Handler : the handler to use |
Throws | |
---|---|
NullPointerException |
if either listener or
handler is null. |
public GestureDetector (GestureDetector.OnGestureListener listener)
This constructor is deprecated.
Use GestureDetector(android.content.Context, android.view.GestureDetector.OnGestureListener)
instead.
Creates a GestureDetector with the supplied listener. You may only use this constructor from a UI thread (this is the usual situation).
Parameters | |
---|---|
listener |
GestureDetector.OnGestureListener : the listener invoked for all the callbacks, this must
not be null. |
Throws | |
---|---|
NullPointerException |
if listener is null. |
See also:
public GestureDetector (Context context, GestureDetector.OnGestureListener listener)
Creates a GestureDetector with the supplied listener.
You may only use this constructor from a Looper
thread.
Parameters | |
---|---|
context |
Context : An Activity or a Context created from
Context#createWindowContext(int, Bundle) |
listener |
GestureDetector.OnGestureListener : the listener invoked for all the callbacks, this must
not be null. If the listener implements the OnDoubleTapListener or
OnContextClickListener then it will also be set as the listener for
these callbacks (for example when using the SimpleOnGestureListener ). |
Throws | |
---|---|
NullPointerException |
if listener is null. |
See also:
public GestureDetector (Context context, GestureDetector.OnGestureListener listener, Handler handler)
Creates a GestureDetector with the supplied listener that runs deferred events on the
thread associated with the supplied Handler
.
Parameters | |
---|---|
context |
Context : An Activity or a Context created from
Context#createWindowContext(int, Bundle) |
listener |
GestureDetector.OnGestureListener : the listener invoked for all the callbacks, this must
not be null. If the listener implements the OnDoubleTapListener or
OnContextClickListener then it will also be set as the listener for
these callbacks (for example when using the SimpleOnGestureListener ). |
handler |
Handler : the handler to use for running deferred listener events. |
Throws | |
---|---|
NullPointerException |
if listener is null. |
See also:
public GestureDetector (Context context, GestureDetector.OnGestureListener listener, Handler handler, boolean unused)
Creates a GestureDetector with the supplied listener that runs deferred events on the
thread associated with the supplied Handler
.
Parameters | |
---|---|
context |
Context : An Activity or a Context created from
Context#createWindowContext(int, Bundle) |
listener |
GestureDetector.OnGestureListener : the listener invoked for all the callbacks, this must
not be null. |
handler |
Handler : the handler to use for running deferred listener events. |
unused |
boolean : currently not used. |
Throws | |
---|---|
NullPointerException |
if listener is null. |
See also:
public boolean isLongpressEnabled ()
Returns | |
---|---|
boolean |
true if longpress is enabled, else false. |
public boolean onGenericMotionEvent (MotionEvent ev)
Analyzes the given generic motion event and if applicable triggers the
appropriate callbacks on the OnGestureListener
supplied.
Parameters | |
---|---|
ev |
MotionEvent : The current motion event. |
Returns | |
---|---|
boolean |
true if the OnGestureListener consumed the event,
else false. |
public boolean onTouchEvent (MotionEvent ev)
Analyzes the given motion event and if applicable triggers the
appropriate callbacks on the OnGestureListener
supplied.
Parameters | |
---|---|
ev |
MotionEvent : The current motion event. |
Returns | |
---|---|
boolean |
true if the OnGestureListener consumed the event,
else false. |
public void setContextClickListener (GestureDetector.OnContextClickListener onContextClickListener)
Sets the listener which will be called for context clicks.
Parameters | |
---|---|
onContextClickListener |
GestureDetector.OnContextClickListener : the listener invoked for all the callbacks, or null to stop
listening for context clicks. |
public void setIsLongpressEnabled (boolean isLongpressEnabled)
Set whether longpress is enabled, if this is enabled when a user presses and holds down you get a longpress event and nothing further. If it's disabled the user can press and hold down and then later moved their finger and you will get scroll events. By default longpress is enabled.
Parameters | |
---|---|
isLongpressEnabled |
boolean : whether longpress should be enabled. |
public void setOnDoubleTapListener (GestureDetector.OnDoubleTapListener onDoubleTapListener)
Sets the listener which will be called for double-tap and related gestures.
Parameters | |
---|---|
onDoubleTapListener |
GestureDetector.OnDoubleTapListener : the listener invoked for all the callbacks, or
null to stop listening for double-tap gestures. |