关于ViewDragHelper常用操作整理

2016-10-28  本文已影响18人  leiiiooo
ViewDragHelper 简单实现类:
public class VGHLayout extends LinearLayout {

  private ViewDragHelper mHelper;
  private View mFreeView;
  private View mEdgeView;
  private View mReleaseView;

  private Point autoBackPoint = new Point();

  public VGHLayout(Context context) {
    this(context, null);
  }

  public VGHLayout(Context context, AttributeSet attrs) {
    this(context, attrs, 0);
  }

  public VGHLayout(Context context, AttributeSet attrs, int defStyleAttr) {
    super(context, attrs, defStyleAttr);
    /**
     * 定义构造函数
     * this-指定当前使用的容器
     * 1.0f-敏感度,越大越敏感
     * Callback-拖拽方法回掉
     *
     * ps:helper.mTouchSlop = (int) (helper.mTouchSlop * (1 / sensitivity));
     */
    mHelper = ViewDragHelper.create(this, 1.0f, new DemoDragHelperCallback());
    mHelper.setEdgeTrackingEnabled(ViewDragHelper.EDGE_LEFT);
  }

  class DemoDragHelperCallback extends ViewDragHelper.Callback {
       /**
       * 如果返回true,则表示可以捕获该view,你可以根据传入的第一个view参数
       * 决定哪些可以捕获
       */
      @Override
      public boolean tryCaptureView(View child, int pointerId) {
        return child != mEdgeView;
      }

      /**
       * 可以在该方法中,对child移动的边界进行控制
       * left和top就是当前view即将移动的位置,需要做相关的边界控制
       */
      @Override
      public int clampViewPositionHorizontal(View child, int left, int dx) {
        final int leftBound = getPaddingLeft();
        final int rightBound = getWidth() - getPaddingRight() - child.getWidth();

        return Math.min(Math.max(left, leftBound), rightBound);
      }

      @Override
      public int clampViewPositionVertical(View child, int top, int dy) {
        final int topBound = getPaddingTop();
        final int bottomBound = getHeight() - getPaddingBottom() - child.getHeight();

        return Math.min(Math.max(top, topBound), bottomBound);
      }

      /**
       * 我们把我们的TextView全部加上clickable=true,意思就是子View可以消耗事件。再次运行,
       * 你会发现本来可以拖动的View不动了,主要是因为,如果子View不消耗事件,
       * 那么整个手势(DOWN-MOVE*-UP)都是直接进入onTouchEvent,在onTouchEvent的DOWN的时候就确定了captureView。
       * 如果消耗事件,那么就会先走onInterceptTouchEvent方法,判断是否可以捕获,
       * 而在判断的过程中会去判断另外两个回调的方法:getViewHorizontalDragRange和getViewVerticalDragRange,
       * 只有这两个方法返回大于0的值才能正常的捕获,方法的返回值为当前view的移动范围,如果只是移动一个方向
       * 则只重写其中的方法即可
       */
      @Override
      public int getViewHorizontalDragRange(View child) {
        return getMeasuredWidth() - child.getMeasuredWidth();
      }

      @Override
      public int getViewVerticalDragRange(View child) {
        return getMeasuredHeight() - child.getMeasuredHeight();
      }


      /**
       * 手指释放时回掉的方法
       */
      @Override
      public void onViewReleased(View releasedChild, float xvel, float yvel) {
        if (releasedChild == mReleaseView) {
            /**
             * 使用下沉的回掉效果
             */
            /**
             * smoothSlideViewTo,将子控件平滑移动到指定位置。它调用了forceSettleCapturedViewAt,在forceSettleCapturedViewAt中会调用Scroller.startScroll方法。
             * settleCapturedViewAt,将子控件移动到指定位置。与smoothSlideViewTo相似,它也调用了forceSettleCapturedViewAt方法。与smoothSlideViewTo不同的是,它以手指离开时的速度为初速度,将子控件移动到指定位置。
             * captureChildView方法,将指定的子控件移动到指定位置。与上面两个方法不同的是,它直接移动到指定位置,不会有时间上的等待,也就是说不会有那种平滑的感觉。
             * lingCapturedView方法,与settleCapturedViewAt类似,都使用了手指离开时的速度作为计算的当前位置的依据。
             */
            mHelper.settleCapturedViewAt(autoBackPoint.x, autoBackPoint.y);
            /**
             * 重新进行绘制
             */
            invalidate();
        }
    }

    /**
     * 在边界拖动时候进行回掉
     */
    @Override
    public void onEdgeDragStarted(int edgeFlags, int pointerId) {

        mHelper.captureChildView(mEdgeView, pointerId);
    }

    /**
     * 当ViewDragHelper状态发生变化时回调(IDLE,DRAGGING,SETTING[自动滚动时])
     */
    @Override
    public void onViewDragStateChanged(int state) {
        super.onViewDragStateChanged(state);
    }

    /**
     * 当captureview的位置发生改变时回调
     */
    @Override
    public void onViewPositionChanged(View changedView, int left, int top, int dx, int dy) {
        super.onViewPositionChanged(changedView, left, top, dx, dy);
    }

    /**
     * 当captureview被捕获时回调
     */
    @Override
    public void onViewCaptured(View capturedChild, int activePointerId) {
        super.onViewCaptured(capturedChild, activePointerId);
    }

    /**
     * true的时候会锁住当前的边界,false则unLock。
     */
    @Override
    public boolean onEdgeLock(int edgeFlags) {
        return super.onEdgeLock(edgeFlags);
    }

    /**
     * 当触摸到边界时回调。
     */
    @Override
    public void onEdgeTouched(int edgeFlags, int pointerId) {
        super.onEdgeTouched(edgeFlags, pointerId);
    }

    /**
     * 改变同一个坐标(x,y)去寻找captureView位置的方法。(具体在:findTopChildUnder方法中)
     */
    @Override
    public int getOrderedChildIndex(int index) {
        return super.getOrderedChildIndex(index);
    }

  }


  /**
   * 将touch事件的拦截和处理交由DragHelper进行处理
   */
  @Override
  public boolean onInterceptHoverEvent(MotionEvent event) {
    return mHelper.shouldInterceptTouchEvent(event);
  }

  @Override
 public boolean onTouchEvent(MotionEvent event) {
    mHelper.processTouchEvent(event);

    return true;
  }

  @Override
  protected void onLayout(boolean changed, int l, int t, int r, int b) {
    super.onLayout(changed, l, t, r, b);

    autoBackPoint.x = mReleaseView.getLeft();
    autoBackPoint.y = mReleaseView.getTop();
  }

  /**
   * 填充完毕后调用此方法
   */
  @Override
  protected void onFinishInflate() {
    super.onFinishInflate();

    mFreeView = getChildAt(0);
    mEdgeView = getChildAt(1);
    mReleaseView = getChildAt(2);
  }

  /**
   * 重写computeScroll方法,实现fling或者松手后的滑动效果
   * computeScroll也不是来让ViewGroup滑动的,真正让ViewGroup滑动的是scrollTo,scrollBy.
   * computeScroll的作用是计算ViewGroup如何滑动
   * 调用startScroll()是不会有滚动效果的,只有在computeScroll()获取滚动情况,做出滚动的响应
   * computeScroll在父控件执行drawChild时,会调用这个方法
   * 并在ViewDragHelper.Callback的onViewReleased()方法里调用
   * settleCapturedViewAt()、flingCapturedView(),或在任意地方调用smoothSlideViewTo()方法。
   */
  @Override
  public void computeScroll() {
    /**
     * continueSettling,当ViewDragHelper的状态是STATE_SETTLING(自动滚动)时,
     * 该方法会将子控件自动进行移动(使用Scroller实现测量空前当前应该处于的位置,
     * 然后调用View.offsetLeftAndRight和View.offsetTopAndBottom方法进行移动)。
     * 在自定义控件中的computeScroll方法中调用。computeScroll方法用于处理自动移动的状况,
     * 通常是在MONTIONEVENT.ACTION_UP的时候,调用Scroller.startScroll方法。
     */
    /**
     * 解析:
     * continueSettling方法调用的是View.offsetLeftAndRight和offsetTopAndBottom方法来实现滑动效果。
     * ViewDragHelper中另一个方法dragTo,同样使用的是offsetLeftAndRight实现滑动,
     * 而dragTo只在processTouchEvent的ACTION_MOVE中调用。
     */
    if (mHelper.continueSettling(true)) {
        invalidate();
    }
  }

  /**
   * 方法正常流程的回掉顺序:
   * shouldInterceptTouchEvent:
   *DOWN:
   * getOrderedChildIndex(findTopChildUnder)
   * ->onEdgeTouched
   *
   * MOVE:
   * getOrderedChildIndex(findTopChildUnder)
   * ->getViewHorizontalDragRange &
   * getViewVerticalDragRange(checkTouchSlop)(MOVE中可能不止一次)
   * ->clampViewPositionHorizontal&
   * clampViewPositionVertical
   * ->onEdgeDragStarted
   * ->tryCaptureView
   * ->onViewCaptured
   * ->onViewDragStateChanged
   *
   * processTouchEvent:
   *
   * DOWN:
   * getOrderedChildIndex(findTopChildUnder)
   * ->tryCaptureView
   * ->onViewCaptured
   * ->onViewDragStateChanged
   * ->onEdgeTouched
   * MOVE:
   * ->STATE==DRAGGING:dragTo
   * ->STATE!=DRAGGING:
   * onEdgeDragStarted
   * ->getOrderedChildIndex(findTopChildUnder)
   * ->getViewHorizontalDragRange&
   * getViewVerticalDragRange(checkTouchSlop)
   * ->tryCaptureView
   * ->onViewCaptured
   * ->onViewDragStateChanged
   * 从上面也可以解释,我们在之前TextView(clickable=false)的情况下,
   * 没有编写getViewHorizontalDragRange方法时,是可以移动的。
   * 因为直接进入processTouchEvent的DOWN,然后就onViewCaptured、onViewDragStateChanged(进入DRAGGING状态),
   * 接下来MOVE就直接dragTo了。
   * 而当子View消耗事件的时候,就需要走shouldInterceptTouchEvent,MOVE的时候经过一系列的判断(getViewHorizontalDragRange,clampViewPositionVertical等),
   * 才能够去tryCaptureView。
   */
}
效果图:
效果如图
上一篇下一篇

猜你喜欢

热点阅读