ViewDragHelper详解（一）- 可拖动的view

ViewDragHelper从名称上就可以看出， 这是一个用来简化view拖拽操作的帮助类。而且使用起来也很简单， 很方便，只需要几个方法和1个Callback就可以实现一个可以拖动到view。

需要注意个是：ViewDragHelper是作用在一个ViewGroup上，也就是说他不能直接作用到被拖拽的view， 其实这也很好理解，因为view在布局中的位置是父ViewGroup决定的。

如何使用ViewGroup实现一个可以拖动的view？

1、获取ViewDragHelper的实例，注意，这里不能直接new，而是使用ViewDragHelper的一个静态方法：

ViewDragHelper.create(ViewGroup forParent, float sensitivity, ViewDragHelper.Callback cb);

参数1： 一个ViewGroup， 也就是ViewDragHelper将要用来拖拽谁下面的子view

参数2：灵敏度，一般设置为1.0f就行

参数3：一个回调，用来处理拖动到位置

2、继承ViewDragHelper.Callback类，该类有个抽象方法：tryCaptureView(View view, int pointerId) 表示尝试捕获子view，这里一定要返回true， 返回true表示允许。

3、重写两个方法int clampViewPositionHorizontal(View child, int left, int dx)和int clampViewPositionHorizontal(View child, int left, int dx) 这两个方法分别用来处理x方向和y方向的拖动的，返回值该child现在的位置。

4、重写ViewGroup的onInterceptTouchEvent(MotionEvent ev)用来拦截事件

5、重写ViewGroup的onTouchEvent(MotionEvent event) 在这里面只要做两件事：mDragHelper.processTouchEvent(event);处理拦截到的事件，这个方法会在返回前分发事件；return true 表示消费了事件。

简单的5步就可以实现一个可以任意拖动到view了，当然我们需要在clampViewPositionHorizontal和clampViewPositionHorizontal中做一点工作，以防止view超出了边界。

详细代码(详细说明都在代码的注释中)：

 public class CustomView extends LinearLayout {
     private ViewDragHelper mDragHelper;

     public CustomView(Context context) {
         super(context);
         init();
     }

     public CustomView(Context context, AttributeSet attrs) {
         super(context, attrs);
         init();
     }

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

     private void init() {
         /**
          * @params ViewGroup forParent 必须是一个ViewGroup
          * @params float sensitivity 灵敏度
          * @params Callback cb 回调
          */
         mDragHelper = ViewDragHelper.create(this, 1.0f, new ViewDragCallback());
     }

     private class ViewDragCallback extends ViewDragHelper.Callback {
         /**
          * 尝试捕获子view，一定要返回true
          * @param View child 尝试捕获的view
          * @param int pointerId 指示器id？
          * 这里可以决定哪个子view可以拖动
          */
         @Override
         public boolean tryCaptureView(View view, int pointerId) {
 //          return mCanDragView == view;
             return true;
         }

         /**
          * 处理水平方向上的拖动
          * @param View child 被拖动到view
          * @param int left 移动到达的x轴的距离
          * @param int dx 建议的移动的x距离
          */
         @Override
         public int clampViewPositionHorizontal(View child, int left, int dx) {
             System.out.println("left = " + left + ", dx = " + dx);

             // 两个if主要是为了让viewViewGroup里
             if(getPaddingLeft() > left) {
                 return getPaddingLeft();
             }

             if(getWidth() - child.getWidth() < left) {
                 return getWidth() - child.getWidth();
             }

             return left;
         }

         /**
          *  处理竖直方向上的拖动
          * @param View child 被拖动到view
          * @param int top 移动到达的y轴的距离
          * @param int dy 建议的移动的y距离
          */
         @Override
         public int clampViewPositionVertical(View child, int top, int dy) {
             // 两个if主要是为了让viewViewGroup里
             if(getPaddingTop() > top) {
                 return getPaddingTop();
             }

             if(getHeight() - child.getHeight() < top) {
                 return getHeight() - child.getHeight();
             }

             return top;
         }

         /**
          * 当拖拽到状态改变时回调
          * @params 新的状态
          */
         @Override
         public void onViewDragStateChanged(int state) {
             switch (state) {
             case ViewDragHelper.STATE_DRAGGING:  // 正在被拖动
                 break;
             case ViewDragHelper.STATE_IDLE:  // view没有被拖拽或者 正在进行fling/snap
                 break;
             case ViewDragHelper.STATE_SETTLING: // fling完毕后被放置到一个位置
                 break;
             }
             super.onViewDragStateChanged(state);
         }
     }

     @Override
     public boolean onInterceptTouchEvent(MotionEvent ev) {
         switch (ev.getAction()) {
         case MotionEvent.ACTION_CANCEL:
         case MotionEvent.ACTION_DOWN:
             mDragHelper.cancel(); // 相当于调用 processTouchEvent收到ACTION_CANCEL
             break;
         }

         /**
          * 检查是否可以拦截touch事件
          * 如果onInterceptTouchEvent可以return true 则这里return true
          */
         return mDragHelper.shouldInterceptTouchEvent(ev);
     }

     @Override
     public boolean onTouchEvent(MotionEvent event) {
         /**
          * 处理拦截到的事件
          * 这个方法会在返回前分发事件
          */
         mDragHelper.processTouchEvent(event);
         return true;
     }
 }

在xml中使用：

 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:tools="http://schemas.android.com/tools"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     android:paddingBottom="@dimen/activity_vertical_margin"
     android:paddingLeft="@dimen/activity_horizontal_margin"
     android:paddingRight="@dimen/activity_horizontal_margin"
     android:paddingTop="@dimen/activity_vertical_margin"
     tools:context=".MainActivity" >

     <org.loader.viewdraghelpertest1.CustomView
         android:layout_width="match_parent"
         android:layout_height="match_parent">
         <View
             android:layout_width="100dp"
             android:layout_height="100dp"
             android:background="#FFFF0000" />
     </org.loader.viewdraghelpertest1.CustomView>

 </RelativeLayout>

看一下效果吧：