ViewDragHelper应用基础篇

下面记录下自己对ViewDragHelper的理解.

一、什么是ViewDragHelper

首先，ViewDragHelper实在官方supportV4包里面，为了方便开发者自定义自己的控件而提出来的，其中官方的DrawLayout的基础实现类是通过ViewDragHelper实现的。我相信读者应该都对DrawLayout比较熟悉，其实自定义一个类似DrawLayout的功能，并不是一件难事！好了，现在直接进入正文。

二、入门小Demo

首先简单说明下使用ViewDragHelper的步骤（这里笔者使用典型的View拖动小Demo，尽可能加入注释描述ViewDragHelper应用）。

1.创建一个ViewGroup
2.实例化ViewDragHelper对象
3.重新部分ViewDragHelper对象回调接口方法

（一）利用ViewDragHelper，实现子View可以拖动效果

首先我们直接看代码：

/**
* 简单的ViewDrawHleper应用 案例
* Created by wsy on 2016/2/29.
*/
public class BasicMoveView extends LinearLayout {
   private final String TAG = "Wusy BasicMoveView";
   private ViewDragHelper dragHelper;
   private Context mContext;
   private View mDragView1;
   private View mDragView2;
   private View mDragView3;
   public BasicMoveView(Context context) {
       super(context);
       this.mContext = context;
       init();
   }
   public BasicMoveView(Context context, AttributeSet attrs) {
       super(context, attrs);
       this.mContext = context;
       init();
   }
   private void init() {
       dragHelper = ViewDragHelper.create(this, 1.0f, new ViewDragHelper.Callback() {
           @Override
           public boolean tryCaptureView(View view, int i) {
               return mDragView1 == view || mDragView2 == view || mDragView3 == view;
           }
           @Override
           public int clampViewPositionHorizontal(View child, int left, int dx) {
               int lefPad = getPaddingLeft();
               int realWidth = getWidth() - child.getWidth();
               int newLeft = Math.min(Math.max(left, lefPad), realWidth);
               return newLeft;
           }
           @Override
           public int clampViewPositionVertical(View child, int top, int dy) {
               int topPad = getPaddingTop();
               int realHeight = getHeight() - child.getHeight();
               int newTop = Math.min(Math.max(top, topPad), realHeight);
               return newTop;
           }      
       });
   }
   /**
    * 事件从父-》子控件 事件传递
    **/
   @Override
   public boolean onInterceptTouchEvent(MotionEvent ev) {
       final int action = MotionEventCompat.getActionMasked(ev);
       if (action == MotionEvent.ACTION_CANCEL || action == MotionEvent.ACTION_UP) {
           dragHelper.cancel();
           return false;
       }
       return dragHelper.shouldInterceptTouchEvent(ev);
   }
   /**
    * 事件从父《-子控件 事件传递
    **/
   @Override
   public boolean onTouchEvent(MotionEvent event) {
       dragHelper.processTouchEvent(event);
       return true;
   }
   @Override
   protected void onFinishInflate() {
       super.onFinishInflate();
       mDragView1 = getChildAt(0);
       mDragView2 = getChildAt(1);
       mDragView3 = getChildAt(2);
   }
}

说明：
1.首先创建ViewDragHelper实例，是通过静态工程提供实例化方法：

dragHelper = ViewDragHelper.create(this, 1.0f, new ViewDragHelper.Callback() {... });

关于这里三个形参的解释：1.自身拖动对象（必须为ViewGroup） 2.敏感度(越大，触发越敏感) 3.操作回调。

2.触摸事件传递给ViewDragHelper必须重写的两个方法

  /**
    * 事件从父-》子控件 事件传递 决定当前事件是否要被截断
    **/
   @Override
   public boolean onInterceptTouchEvent(MotionEvent ev) {
       return dragHelper.shouldInterceptTouchEvent(ev);
   }
   /**
    * 事件从父《-子控件 事件传递 决定当前事件的处理
    **/
   @Override
   public boolean onTouchEvent(MotionEvent event) {
       dragHelper.processTouchEvent(event);
       return true;
   }

3.一切触摸移动事件取决于ViewDragHelper.CallCack回调重写。
这里我们看下如果实现子View需要重写的三个方法

@Override
public boolean tryCaptureView(View childView, int i) {
              return mDragView1 == childView || mDragView2 == childView|| mDragView3 == childView;
          }

/** 水平控制子View位置 left为x坐标 childView横向的移动的范围**/
@Override
public int clampViewPositionHorizontal(View child, int left, int dx) {
              int lefPad = getPaddingLeft();
              int realWidth = getWidth() - child.getWidth();
              int newLeft = Math.min(Math.max(left, lefPad), realWidth);
              return newLeft;
          }

/** 垂直控制子View位置 top y坐标 childView纵向的移动的范围**/
@Override
public int clampViewPositionVertical(View child, int top, int dy) {
              int topPad = getPaddingTop();
              int realHeight = getHeight() - child.getHeight();
              int newTop = Math.min(Math.max(top, topPad), realHeight);
              return newTop;
          }

(1)tryCaptureView()方法主要决定受控制子View，当判断满足条件的childView，即返回true后即可回调下面出发事件
(3)clampViewPositionHorizontal() 控制子View移动位置，返回值为横向移动范围
(3)clampViewPositionVertical()控制子View移动位置，返回值为纵向移动范围
4.具体应用
一下是效果与布局代码

（二）通过ViewDragHelper实现边缘控制与运动回放

/** 边缘控制 **/
           @Override
           public void onEdgeTouched(int edgeFlags, int pointerId) {
               super.onEdgeTouched(edgeFlags, pointerId);
               Toast.makeText(mContext, "在最左边", Toast.LENGTH_SHORT).show();
           }
           /** 边缘动态控制view **/
           @Override
           public void onEdgeDragStarted(int edgeFlags, int pointerId) {
               super.onEdgeDragStarted(edgeFlags, pointerId);
               dragHelper.captureChildView(mDragView1, pointerId);
           }
           /** 拖动回放 **/
           @Override
           public void onViewReleased(View releasedChild, float xvel, float yvel) {
               super.onViewReleased(releasedChild, xvel, yvel);
               if (releasedChild == mDragView3) {
                   Log.i(TAG,"指定View被释放了,位置在：x-> "+mDragView3.getX()+" y-> "+mDragView3.getY());
                   dragHelper.settleCapturedViewAt(backViewPoint.x, backViewPoint.y);//源码内部mScroller.startScroll，配合computeScroll才能实现invalidate()
                   invalidate();
               }
           }

onEdgeTouched() 前提指定边缘方向监听后，如果触摸坐标达到边缘即出发事件

onEdgeDragStarted() 前提指定边缘方向监听后，触摸坐标达到边缘后，当触摸坐标移动的时候会回调这个方法。dragHelper.captureChildView(mDragView1, pointerId) 这里是当坐标在屏幕边缘的时候，坐标移动回调返回的pointerId，直接将制定捕获的View，进行位移操作。

onViewReleased() 当其中一个捕获到的子View，释放的时候回调这个方法。这里View移动后回滚到原来位置的原理是，初始化的Onlayout的时候，先临时存储了原来的x，y坐标，当捕获的View释放的时候，重新让它绘制到这个位置。注意：这里需要配合computeScroll方法（我们看settleCapturedViewAt源码得知通过mScroller.startScroll滚动改变位移）。
//设置使能边缘

 dragHelper.setEdgeTrackingEnabled(ViewDragHelper.EDGE_LEFT);

指定边缘方向监听。

 @Override
 public void computeScroll() {
 if(dragHelper.continueSettling(true)){
 invalidate();
 } }

（三）注意

如果其中子View有监听事件，必须重写以下两个方法：

 /**添加了clickable = true ，都记得重写下面这两个方法**/
 @Override
 public int getViewHorizontalDragRange(View child) {
 return getMeasuredWidth()-child.getMeasuredWidth();
 }
 @Override
 public int getViewVerticalDragRange(View child) {
 return getMeasuredHeight()-child.getMeasuredHeight();
 }

三、简单描述未使用接口作用

到此，我们列一下所有的Callback方法，看看还有哪些没用过的：

onViewDragStateChanged
当ViewDragHelper状态发生变化时回调（IDLE,DRAGGING,SETTING[自动滚动时]）

onViewPositionChanged
当captureview的位置发生改变时回调

onViewCaptured
当captureview被捕获时回调

onViewReleased 已用

onEdgeTouched
当触摸到边界时回调。

onEdgeLock
true的时候会锁住当前的边界，false则unLock。

onEdgeDragStarted 已用

getOrderedChildIndex
改变同一个坐标（x,y）去寻找captureView位置的方法。（具体在：findTopChildUnder方法中）

getViewHorizontalDragRange 已用

getViewVerticalDragRange 已用
tryCaptureView 已用
clampViewPositionHorizontal 已用
clampViewPositionVertical 已用

ok，至此所有的回调方法都有了一定的认识。
总结下，方法的大致的回调顺序：

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

ok，上述是正常情况下大致的流程，当然整个过程可能会存在很多判断不成立的情况。

四、总结

http://blog.csdn.net/pi9nc/article/details/39583377
http://blog.csdn.net/lmj623565791/article/details/46858663

傻小孩b mark