Android进阶之自定义View实战(四)ViewDragHelper入门

引言

在前面几篇自定义View实战的博客中,我们学习了自定义View的基本套路，而针对自定义ViewGroup,关键在于以下几点:
1.ViewGroup及其子View的测量:onMeasure方法;
2.子View的布局:onLayout方法;
3.如果子View的需要平滑滚动，需要结合Scroller;
4.触摸事件的分发拦截处理dispatchTouchEvent,onInterceptTouchEvent,onTouchEvent
以上几点各路大神都有全面深入的分析,本篇博客主要目的是向大家推荐一个自定义ViewGroup的神器: ViewDragHelper(官方文档)。它可以方便我们处理边界检测、触摸事件处理、速度检测等等。

ViewDragHelper is a utility class for writing custom ViewGroups. It offers a number of useful operations and state tracking for allowing a user to drag and reposition views within their parent ViewGroup.

关于ViewDragHelper需要认识一下特点:
1.ViewDragHelper可以检测到是否触及到边缘以及触发边缘的方向;
2.ViewDragHelper.Callback是连接ViewDragHelper与view之间的桥梁（这个view一般是指拥子view的容器即parentView);
3.ViewDragHelper并不是直接作用于要被拖动的View，而是使其控制的视图容器中的子View可以被拖动，如果要指定某个子view的行为，需要在Callback中想办法,实际开发中主要是实现这个Callback;

入门API

下面的大部分内容来自此处

初始化

ViewDragHelper一般用在一个自定义ViewGroup的内部，比如下面自定义了一个继承于LinearLayout的DragLayout，DragLayout内部有一个子view mDragView作为成员变量：

public class DragLayout extends LinearLayout {

private final ViewDragHelper mDragHelper;
private View mDragView;

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

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

public DragLayout(Context context, AttributeSet attrs, int defStyle) {
  super(context, attrs, defStyle);
}

创建一个带有回调接口的ViewDragHelper:

public DragLayout(Context context, AttributeSet attrs, int defStyle) {
  super(context, attrs, defStyle);
  mDragHelper = ViewDragHelper.create(this, 1.0f, new DragHelperCallback());
}

其中1.0f是敏感度参数参数越大越敏感。

mDragHelper.mTouchSlop = (int) (helper.mTouchSlop * (1 / sensitivity));

第一个参数为this，表示该类生成的对象，它是ViewDragHelper的拖动处理对象，必须为ViewGroup。
手势处理:

@Override
public boolean onInterceptTouchEvent(MotionEvent ev) {
  final int action = MotionEventCompat.getActionMasked(ev);
  if (action == MotionEvent.ACTION_CANCEL || action == MotionEvent.ACTION_UP) {
      mDragHelper.cancel();
      return false;
  }
  return mDragHelper.shouldInterceptTouchEvent(ev);
}

@Override
public boolean onTouchEvent(MotionEvent ev) {
  mDragHelper.processTouchEvent(ev);
  return true;
}

接下来，你就可以在回调中处理各种拖动行为了。

子View的行为处理

先看看Callback的方法

new ViewDragHelper.Callback()
        {
            @Override
            public boolean tryCaptureView(View child, int pointerId)
            {
                return true;
            }

            @Override
            public int clampViewPositionHorizontal(View child, int left, int dx)
            {
                return left;
            }

            @Override
            public int clampViewPositionVertical(View child, int top, int dy)
            {
                return top;
            }
        }

• tryCaptureView如何返回ture则表示可以捕获该view，你可以根据传入的第一个view参数决定可以捕获那些子View，假如有两个子View：mDragView1和mDragView2，之允许mDragView1可以被拖动，实现如下:

@Override
public boolean tryCaptureView(View child, int pointerId) {
    return child == mDragView1;
}

• clampViewPositionHorizontal,clampViewPositionVertical确定捕获的View的移动边界。第二个参数是指当前拖动子view应该到达的x坐标。所以默认返回第二个参数就可以了，但为了让被拖动的view遇到边界之后就不在拖动，对返回的值需要做阈值限定:

@Override
public int clampViewPositionHorizontal(View child, int left, int dx) {
    Log.d("DragLayout", "clampViewPositionHorizontal " + left + "," + dx);
    final int leftBound = getPaddingLeft();
    final int rightBound = getWidth() - mDragView.getWidth();
    final int newLeft = Math.min(Math.max(left, leftBound), rightBound);
    return newLeft;
}

@Override
public int clampViewPositionVertical(View child, int top, int dy) {
    final int topBound = getPaddingTop();
    final int bottomBound = getHeight() - mDragView.getHeight();
    final int newTop = Math.min(Math.max(top, topBound), bottomBound);
    return newTop;
 }

到目前为止，我们就完成了一个简单的自定义ViewGroup，可以自由的拖动它的儿子mDragView。
下面我们在看看边界检测：边缘滑动分为滑动左边缘还是右边缘：EDGE_LEFT和EDGE_RIGHT，下面的代码设置了可以处理滑动左边缘：

mDragHelper.setEdgeTrackingEnabled(ViewDragHelper.EDGE_LEFT);

如果你想在边缘滑动的时候根据滑动距离移动一个子view，可以通过实现onEdgeDragStarted方法，并在onEdgeDragStarted方法中手动指定要移动的子View:

@Override
public void onEdgeDragStarted(int edgeFlags, int pointerId) {
    mDragHelper.captureChildView(mDragView2, pointerId);
}

另外它还可以实现View的平滑滚动,下面是在捕获的View松手手势下回到原来位置的实现，这里用到Scroller,所以需要颠写computeScroll方法实现惯性滚动。

   @Override
   public void onViewReleased(View releasedChild, float xvel, float yvel) {
      if(releasedChild == mAutoBackView){
          mDragHelper.settleCapturedViewAt(mAutoBackOriginPos.x, mAutoBackOriginPos.y);
          invalidate();//启动滚动
       }
       super.onViewReleased(releasedChild, xvel, yvel);
   }

 @Override
    public void computeScroll() {
        super.computeScroll();
        if (mViewDragHelper.continueSettling(true)) {//不停计算位置后，自动移动
            ViewCompat.postInvalidateOnAnimation(DragView.this);//重新绘制
        }
    }

本篇对ViewDragHelper的常用API就介绍到这里,下一篇博客将介绍一个实战范例。GayHub地址