com.freerdp.freerdpcore.utils.GestureDetector Class Reference

Data Structures
interface	OnDoubleTapListener
interface	OnGestureListener
class	SimpleOnGestureListener

Public Member Functions
	GestureDetector (Context context, OnGestureListener listener)
	GestureDetector (Context context, OnGestureListener listener, Handler handler)
	GestureDetector (Context context, OnGestureListener listener, Handler handler, boolean ignoreMultitouch)
void	setOnDoubleTapListener (OnDoubleTapListener onDoubleTapListener)
void	setIsLongpressEnabled (boolean isLongpressEnabled)
boolean	isLongpressEnabled ()
void	setLongPressTimeout (int timeout)
boolean	onTouchEvent (MotionEvent ev)

Detailed Description

Definition at line 28 of file GestureDetector.java.

Constructor & Destructor Documentation

GestureDetector() [1/3]

com.freerdp.freerdpcore.utils.GestureDetector.GestureDetector ( Context  context, OnGestureListener  listener  )

inline

Creates a GestureDetector with the supplied listener. You may only use this constructor from a UI thread (this is the usual situation).

Parameters

context	the application's context
listener	the listener invoked for all the callbacks, this must not be null.

Exceptions

NullPointerException

if listener is null.

See also

android.os.Handler::Handler()

Definition at line 79 of file GestureDetector.java.

  {
    this(context, listener, null);
  }

GestureDetector() [2/3]

com.freerdp.freerdpcore.utils.GestureDetector.GestureDetector ( Context  context, OnGestureListener  listener, Handler  handler  )

inline

Creates a GestureDetector with the supplied listener. You may only use this constructor from a UI thread (this is the usual situation).

Parameters

context	the application's context
listener	the listener invoked for all the callbacks, this must not be null.
handler	the handler to use

Exceptions

NullPointerException

if listener is null.

See also

android.os.Handler::Handler()

Definition at line 95 of file GestureDetector.java.

  {
    this(context, listener, handler, context != null);
  }

GestureDetector() [3/3]

com.freerdp.freerdpcore.utils.GestureDetector.GestureDetector ( Context  context, OnGestureListener  listener, Handler  handler, boolean  ignoreMultitouch  )

inline

Creates a GestureDetector with the supplied listener. You may only use this constructor from a UI thread (this is the usual situation).

Parameters

context	the application's context
listener	the listener invoked for all the callbacks, this must not be null.
handler	the handler to use
ignoreMultitouch	whether events involving more than one pointer should be ignored.

Exceptions

NullPointerException

if listener is null.

See also

android.os.Handler::Handler()

Definition at line 113 of file GestureDetector.java.

  {
    if (handler != null)
    {
      mHandler = new GestureHandler(handler);
    }
    else
    {
      mHandler = new GestureHandler();
    }
    mListener = listener;
    if (listener instanceof OnDoubleTapListener)
    {
      setOnDoubleTapListener((OnDoubleTapListener)listener);
    }
    init(context, ignoreMultitouch);
  }

References com.freerdp.freerdpcore.utils.GestureDetector.setOnDoubleTapListener().

Here is the call graph for this function:

Member Function Documentation

isLongpressEnabled()

boolean com.freerdp.freerdpcore.utils.GestureDetector.isLongpressEnabled ( )

inline

Returns

true if longpress is enabled, else false.

Definition at line 193 of file GestureDetector.java.

  {
    return mIsLongpressEnabled;
  }

Referenced by com.freerdp.freerdpcore.utils.GestureDetector.setIsLongpressEnabled().

Here is the caller graph for this function:

onTouchEvent()

boolean com.freerdp.freerdpcore.utils.GestureDetector.onTouchEvent ( MotionEvent  ev )

inline

Analyzes the given motion event and if applicable triggers the appropriate callbacks on the OnGestureListener supplied.

Parameters

ev	The current motion event.

Returns

true if the OnGestureListener consumed the event, else false.

Definition at line 211 of file GestureDetector.java.

  {
    final int action = ev.getAction();
    final float y = ev.getY();
    final float x = ev.getX();
 
    boolean handled = false;
 
    switch (action & MotionEvent.ACTION_MASK)
    {
      case MotionEvent.ACTION_POINTER_DOWN:
        if (mIgnoreMultitouch)
        {
          // Multitouch event - abort.
          cancel();
        }
        break;
 
      case MotionEvent.ACTION_POINTER_UP:
        // Ending a multitouch gesture and going back to 1 finger
        if (mIgnoreMultitouch && ev.getPointerCount() == 2)
        {
          int index = (((action & MotionEvent.ACTION_POINTER_INDEX_MASK) >>
                        MotionEvent.ACTION_POINTER_INDEX_SHIFT) == 0)
                          ? 1
                          : 0;
          mLastMotionX = ev.getX(index);
          mLastMotionY = ev.getY(index);
        }
        break;
 
      case MotionEvent.ACTION_DOWN:
        if (mDoubleTapListener != null)
        {
          boolean hadTapMessage = mHandler.hasMessages(TAP);
          if (hadTapMessage)
            mHandler.removeMessages(TAP);
          if ((mCurrentDownEvent != null) && (mPreviousUpEvent != null) &&
              hadTapMessage &&
              isConsideredDoubleTap(mCurrentDownEvent, mPreviousUpEvent, ev))
          {
            // This is a second tap
            mIsDoubleTapping = true;
            // Give a callback with the first tap of the double-tap
            handled |= mDoubleTapListener.onDoubleTap(mCurrentDownEvent);
            // Give a callback with down event of the double-tap
            handled |= mDoubleTapListener.onDoubleTapEvent(ev);
          }
          else
          {
            // This is a first tap
            mHandler.sendEmptyMessageDelayed(TAP, DOUBLE_TAP_TIMEOUT);
          }
        }
 
        mLastMotionX = x;
        mLastMotionY = y;
        if (mCurrentDownEvent != null)
        {
          mCurrentDownEvent.recycle();
        }
        mCurrentDownEvent = MotionEvent.obtain(ev);
        mAlwaysInTapRegion = true;
        mAlwaysInBiggerTapRegion = true;
        mStillDown = true;
        mInLongPress = false;
 
        if (mIsLongpressEnabled)
        {
          mHandler.removeMessages(LONG_PRESS);
          mHandler.sendEmptyMessageAtTime(LONG_PRESS, mCurrentDownEvent.getDownTime() +
                                                          TAP_TIMEOUT +
                                                          mLongpressTimeout);
        }
        mHandler.sendEmptyMessageAtTime(SHOW_PRESS,
                                        mCurrentDownEvent.getDownTime() + TAP_TIMEOUT);
        handled |= mListener.onDown(ev);
        break;
 
      case MotionEvent.ACTION_MOVE:
        if (mIgnoreMultitouch && ev.getPointerCount() > 1)
        {
          break;
        }
        final float scrollX = mLastMotionX - x;
        final float scrollY = mLastMotionY - y;
        if (mIsDoubleTapping)
        {
          // Give the move events of the double-tap
          handled |= mDoubleTapListener.onDoubleTapEvent(ev);
        }
        else if (mAlwaysInTapRegion)
        {
          final int deltaX = (int)(x - mCurrentDownEvent.getX());
          final int deltaY = (int)(y - mCurrentDownEvent.getY());
          int distance = (deltaX * deltaX) + (deltaY * deltaY);
          if (distance > mTouchSlopSquare)
          {
            mLastMotionX = x;
            mLastMotionY = y;
            mAlwaysInTapRegion = false;
            mHandler.removeMessages(TAP);
            mHandler.removeMessages(SHOW_PRESS);
            mHandler.removeMessages(LONG_PRESS);
          }
          if (distance > mLargeTouchSlopSquare)
          {
            mAlwaysInBiggerTapRegion = false;
          }
          handled = mListener.onScroll(mCurrentDownEvent, ev, scrollX, scrollY);
        }
        else if ((Math.abs(scrollX) >= 1) || (Math.abs(scrollY) >= 1))
        {
          handled = mListener.onScroll(mCurrentDownEvent, ev, scrollX, scrollY);
          mLastMotionX = x;
          mLastMotionY = y;
        }
        break;
 
      case MotionEvent.ACTION_UP:
        mStillDown = false;
        MotionEvent currentUpEvent = MotionEvent.obtain(ev);
        if (mIsDoubleTapping)
        {
          // Finally, give the up event of the double-tap
          handled |= mDoubleTapListener.onDoubleTapEvent(ev);
        }
        else if (mInLongPress)
        {
          mHandler.removeMessages(TAP);
          mListener.onLongPressUp(ev);
          mInLongPress = false;
        }
        else if (mAlwaysInTapRegion)
        {
          handled = mListener.onSingleTapUp(mCurrentDownEvent);
        }
        else
        {
          // A fling must travel the minimum tap distance
        }
        if (mPreviousUpEvent != null)
        {
          mPreviousUpEvent.recycle();
        }
        // Hold the event we obtained above - listeners may have changed the original.
        mPreviousUpEvent = currentUpEvent;
        mIsDoubleTapping = false;
        mHandler.removeMessages(SHOW_PRESS);
        mHandler.removeMessages(LONG_PRESS);
        handled |= mListener.onUp(ev);
        break;
      case MotionEvent.ACTION_CANCEL:
        cancel();
        break;
    }
    return handled;
  }

References com.freerdp.freerdpcore.utils.GestureDetector.OnDoubleTapListener.onDoubleTap(), com.freerdp.freerdpcore.utils.GestureDetector.OnDoubleTapListener.onDoubleTapEvent(), com.freerdp.freerdpcore.utils.GestureDetector.OnGestureListener.onDown(), com.freerdp.freerdpcore.utils.GestureDetector.OnGestureListener.onLongPressUp(), com.freerdp.freerdpcore.utils.GestureDetector.OnGestureListener.onScroll(), com.freerdp.freerdpcore.utils.GestureDetector.OnGestureListener.onSingleTapUp(), and com.freerdp.freerdpcore.utils.GestureDetector.OnGestureListener.onUp().

Here is the call graph for this function:

setIsLongpressEnabled()

void com.freerdp.freerdpcore.utils.GestureDetector.setIsLongpressEnabled ( boolean  isLongpressEnabled )

inline

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

whether longpress should be enabled.

Definition at line 185 of file GestureDetector.java.

  {
    mIsLongpressEnabled = isLongpressEnabled;
  }

References com.freerdp.freerdpcore.utils.GestureDetector.isLongpressEnabled().

Here is the call graph for this function:

setLongPressTimeout()

void com.freerdp.freerdpcore.utils.GestureDetector.setLongPressTimeout ( int  timeout )

inline

Definition at line 198 of file GestureDetector.java.

  {
    mLongpressTimeout = timeout;
  }

setOnDoubleTapListener()

void com.freerdp.freerdpcore.utils.GestureDetector.setOnDoubleTapListener ( OnDoubleTapListener  onDoubleTapListener )

inline

Sets the listener which will be called for double-tap and related gestures.

Parameters

onDoubleTapListener

the listener invoked for all the callbacks, or null to stop listening for double-tap gestures.

Definition at line 171 of file GestureDetector.java.

  {
    mDoubleTapListener = onDoubleTapListener;
  }

Referenced by com.freerdp.freerdpcore.utils.GestureDetector.GestureDetector().

Here is the caller graph for this function:

---

The documentation for this class was generated from the following file:

• GestureDetector.java