Android ViewDragHelper完全解析 自定义ViewGroup神器

一、概述

在自定义ViewGroup中，很多效果都包含用户手指去拖动其内部的某个View(eg:侧滑菜单等)，针对具体的需要去写好onInterceptTouchEvent和onTouchEvent这两个方法是一件很不容易的事，需要自己去处理：多手指的处理、加速度检测等等。

二、入门小示例

首先我们通过一个简单的例子来看看其快捷的用法，分为以下几个步骤：

1.创建实例

2.触摸相关方法的调用

3.ViewDragHelper.Callback实例的编写

（一）自定义一个ViewGroup

package com.zhjy.hxf.hzviewgroup.view;import android.content.Context;import android.support.v4.widget.ViewDragHelper;import android.util.AttributeSet;import android.view.MotionEvent;import android.view.View;import android.widget.LinearLayout;/** * @author :huangxianfeng on 2017/1/18. * * 实现三个步骤： * 1.创建实例对象 * 2.触摸相关方法的调用 * 3.ViewDragHelper.Callback()方法的实现 */public class VDHLayout extends LinearLayout {    private ViewDragHelper mDragger;    public VDHLayout(Context context, AttributeSet attrs) {        super(context, attrs);        //创建一个实例对象        mDragger = ViewDragHelper.create(this,1.0f, new ViewDragHelper.Callback() {            /**             * 如何返回ture则表示可以捕获该view，你可以根据传入的第一个view参数决定哪些可以捕获             * @param child             * @param pointerId             * @return             */            @Override            public boolean tryCaptureView(View child, int pointerId) {                return true;            }            /**             * clampViewPositionVertical();             * clampViewPositionHorizontal();             * 以上两个方法，可以在该方法中对child移动的边界进行控制，left , top             * 分别为即将移动到的位置，比如横向的情况下，我希望只在ViewGroup的内部移动             * @param child             * @param top             * @param dy             * @return             */            @Override            public int clampViewPositionVertical(View child, int top, int dy) {                return top;            }            @Override            public int clampViewPositionHorizontal(View child, int left, int dx) {                return left;            }        });    }    /**     * 判断事件是否进行拦截     * @param ev     * @return     */    @Override    public boolean onInterceptTouchEvent(MotionEvent ev) {        return mDragger.shouldInterceptTouchEvent(ev);    }    /**     * 拦截之后进行处理     * @param event     * @return     */    @Override    public boolean onTouchEvent(MotionEvent event) {        mDragger.processTouchEvent(event);        return true;    }}

1、创建实例

//创建一个实例对象        mDragger = ViewDragHelper.create(this,1.0f, new ViewDragHelper.Callback() {            /**             * 如何返回ture则表示可以捕获该view，你可以根据传入的第一个view参数决定哪些可以捕获             * @param child             * @param pointerId             * @return             */            @Override            public boolean tryCaptureView(View child, int pointerId) {                return true;            }            /**             * clampViewPositionVertical();             * clampViewPositionHorizontal();             * 以上两个方法，可以在该方法中对child移动的边界进行控制，left , top             * 分别为即将移动到的位置，比如横向的情况下，我希望只在ViewGroup的内部移动             * @param child             * @param top             * @param dy             * @return             */            @Override            public int clampViewPositionVertical(View child, int top, int dy) {                return top;            }            @Override            public int clampViewPositionHorizontal(View child, int left, int dx) {                return left;            }        });

创建实例需要3个参数，第一个就是当前的ViewGroup，第二个sensitivity，主要用于设置touchSlop:

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

可见传入越大，mTouchSlop的值就会越小。第三个参数就是Callback，在用户的触摸过程中会回调相关方法，后面会细说。

2、触摸相关方法

 /**     * 判断事件是否进行拦截     * @param ev     * @return     */    @Override    public boolean onInterceptTouchEvent(MotionEvent ev) {        return mDragger.shouldInterceptTouchEvent(ev);    }    /**     * 拦截之后进行处理     * @param event     * @return     */    @Override    public boolean onTouchEvent(MotionEvent event) {        mDragger.processTouchEvent(event);        return true;    }

onInterceptTouchEvent中通过使用mDragger.shouldInterceptTouchEvent(event)来决定我们是否应该拦截当前的事件。onTouchEvent中通过mDragger.processTouchEvent(event)处理事件。

3、实现ViewDragHelper.CallCack相关方法

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;            }        }

ViewDragHelper中拦截和处理事件时，需要会回调CallBack中的很多方法来决定一些事，比如：哪些子View可以移动、对个移动的View的边界的控制等等。

上面复写的3个方法：

tryCaptureView如何返回ture则表示可以捕获该view，你可以根据传入的第一个view参数决定哪些可以捕获

clampViewPositionHorizontal,clampViewPositionVertical可以在该方法中对child移动的边界进行控制，left , top 分别为即将移动到的位置，比如横向的情况下，我希望只在ViewGroup的内部移动。

即：最小>=paddingleft，最大<=ViewGroup.getWidth()-paddingright-child.getWidth。就可以按照如下代码编写：

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

经过上述3个步骤，我们就完成了一个简单的自定义ViewGroup，可以自由的拖动子View。

（二）布局文件

<?xml version="1.0" encoding="utf-8"?><com.zhjy.hxf.hzviewgroup.view.VDHLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="match_parent"    android:layout_height="match_parent"    android:orientation="vertical">    <TextView        android:layout_width="100dp"        android:layout_height="100dp"        android:layout_gravity="center"        android:layout_margin="10dp"        android:background="#44ff0000"        android:gravity="center"        android:text="I can be dragged !" />    <TextView        android:layout_width="100dp"        android:layout_height="100dp"        android:layout_gravity="center"        android:layout_margin="10dp"        android:background="#44ff0000"        android:gravity="center"        android:text="I can be dragged !" />    <TextView        android:layout_width="100dp"        android:layout_height="100dp"        android:layout_gravity="center"        android:layout_margin="10dp"        android:background="#44ff0000"        android:gravity="center"        android:text="I can be dragged !" /></com.zhjy.hxf.hzviewgroup.view.VDHLayout>

自定义的ViewGroup有三个TextView，就可以实现如下效果。

上面三个TextView是可以随意移动的。

有了直观的认识以后，我们还需要对ViewDragHelper.CallBack里面的方法做下深入的理解。首先我们需要考虑的是：我们的ViewDragHelper不仅仅说只能够去让子View去跟随我们手指移动，我们继续往下学习其他的功能。

三、功能展示

ViewDragHelper还能做以下的一些操作：

• 边界检测、加速度检测(eg：DrawerLayout边界触发拉出)
• 回调Drag Release（eg：DrawerLayout部分，手指抬起，自动展开/收缩）
• 移动到某个指定的位置(eg:点击Button，展开/关闭Drawerlayout)

那么我们接下来对我们最基本的例子进行改造，包含上述的几个操作。

效果是第一个与之前效果一样，第二个是迅速回到原来位置，第三个是边缘检测到移动之后才会移动。

第一个View，就是演示简单的移动
第二个View，演示除了移动后，松手自动返回到原本的位置。（注意你拖动的越快，返回的越快）
第三个View，边界移动时对View进行捕获。

修改后的代码：

package com.zhjy.hxf.hzviewgroup.view;import android.content.Context;import android.graphics.Point;import android.support.v4.widget.ViewDragHelper;import android.util.AttributeSet;import android.view.MotionEvent;import android.view.View;import android.widget.LinearLayout;/** * @author :huangxianfeng on 2017/1/18. *         <p/> *         实现三个步骤： *         1.创建实例对象 *         2.触摸相关方法的调用 *         3.ViewDragHelper.Callback()方法的实现 */public class VDHLayout extends LinearLayout {    private ViewDragHelper mDragger;    private View mDragView;    private View mAutoBackView;    private View mEdgeTrackerView;    private Point mAutoBackOriginPos = new Point();    public VDHLayout(Context context, AttributeSet attrs) {        super(context, attrs);        //创建一个实例对象        mDragger = ViewDragHelper.create(this, 1.0f, new ViewDragHelper.Callback() {            /**             * 如何返回ture则表示可以捕获该view，你可以根据传入的第一个view参数决定哪些可以捕获             * @param child             * @param pointerId             * @return             */            @Override            public boolean tryCaptureView(View child, int pointerId) {                //mEdgeTrackerView禁止直接移动                return child == mDragView || child == mAutoBackView;            }            /**             * clampViewPositionVertical();             * clampViewPositionHorizontal();             * 以上两个方法，可以在该方法中对child移动的边界进行控制，left , top             * 分别为即将移动到的位置，比如横向的情况下，我希望只在ViewGroup的内部移动             * @param child             * @param top             * @param dy             * @return             */            @Override            public int clampViewPositionVertical(View child, int top, int dy) {                return top;            }            @Override            public int clampViewPositionHorizontal(View child, int left, int dx) {                return left;            }            @Override            public void onViewReleased(View releasedChild, float xvel, float yvel) {                super.onViewReleased(releasedChild, xvel, yvel);                //mAutoBackView手指释放时可以自动回去                if (releasedChild == mAutoBackView) {                    mDragger.settleCapturedViewAt(mAutoBackOriginPos.x, mAutoBackOriginPos.y);                    invalidate();                }            }            @Override            public void onEdgeDragStarted(int edgeFlags, int pointerId) {                super.onEdgeDragStarted(edgeFlags, pointerId);                mDragger.captureChildView(mEdgeTrackerView, pointerId);            }        });        mDragger.setEdgeTrackingEnabled(ViewDragHelper.EDGE_LEFT);    }    /**     * 判断事件是否进行拦截     *     * @param ev     * @return     */    @Override    public boolean onInterceptTouchEvent(MotionEvent ev) {        return mDragger.shouldInterceptTouchEvent(ev);    }    /**     * 拦截之后进行处理     *     * @param event     * @return     */    @Override    public boolean onTouchEvent(MotionEvent event) {        mDragger.processTouchEvent(event);        return true;    }    @Override    public void computeScroll() {        super.computeScroll();        if (mDragger.continueSettling(true)) {            invalidate();        }    }    @Override    protected void onLayout(boolean changed, int l, int t, int r, int b) {        super.onLayout(changed, l, t, r, b);        mAutoBackOriginPos.x = mAutoBackView.getLeft();        mAutoBackOriginPos.y = mAutoBackView.getTop();    }    @Override    protected void onFinishInflate() {        super.onFinishInflate();        mDragView = getChildAt(0);        mAutoBackView = getChildAt(1);        mEdgeTrackerView = getChildAt(2);    }}

第一个View基本没做任何修改。

第二个View，我们在onLayout之后保存了最开启的位置信息，最主要还是重写了Callback中的onViewReleased，我们在onViewReleased中判断如果是mAutoBackView则调用settleCapturedViewAt回到初始的位置。大家可以看到紧随其后的代码是invalidate();因为其内部使用的是mScroller.startScroll，所以别忘了需要invalidate()以及结合computeScroll方法一起。

第三个View，我们在onEdgeDragStarted回调方法中，主动通过captureChildView对其进行捕获，该方法可以绕过tryCaptureView，所以我们的tryCaptureView虽然并为返回true，但却不影响。注意如果需要使用边界检测需要添加上mDragger.setEdgeTrackingEnabled(ViewDragHelper.EDGE_LEFT)。

---

到此，我们已经介绍了Callback中常用的回调方法了，当然还有一些方法没有介绍，接下来我们修改下我们的布局文件，我们把我们的TextView全部加上clickable=true，意思就是子View可以消耗事件。再次运行，你会发现本来可以拖动的View不动了，（如果有拿Button测试的兄弟应该已经发现这个问题了，我希望你看到这了，而不是已经提问了,哈~）。

原因是什么呢？主要是因为，如果子View不消耗事件，那么整个手势（DOWN-MOVE*-UP）都是直接进入onTouchEvent，在onTouchEvent的DOWN的时候就确定了captureView。如果消耗事件，那么就会先走onInterceptTouchEvent方法，判断是否可以捕获，而在判断的过程中会去判断另外两个回调的方法：getViewHorizontalDragRange和getViewVerticalDragRange，只有这两个方法返回大于0的值才能正常的捕获。

所以，如果你用Button测试，或者给TextView添加了clickable = true ，都记得在CallBack中重写下面这两个方法：

@Overridepublic int getViewHorizontalDragRange(View child){     return getMeasuredWidth()-child.getMeasuredWidth();}@Overridepublic int getViewVerticalDragRange(View child){     return getMeasuredHeight()-child.getMeasuredHeight();}

方法的返回值应当是该childView横向或者纵向的移动的范围，当前如果只需要一个方向移动，可以只复写一个。

到此，我们列一下所有的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)    ->onEdgeTouchedMOVE:    getOrderedChildIndex(findTopChildUnder)    ->getViewHorizontalDragRange &       getViewVerticalDragRange(checkTouchSlop)(MOVE中可能不止一次)    ->clampViewPositionHorizontal&      clampViewPositionVertical    ->onEdgeDragStarted    ->tryCaptureView    ->onViewCaptured    ->onViewDragStateChangedprocessTouchEvent:DOWN:    getOrderedChildIndex(findTopChildUnder)    ->tryCaptureView    ->onViewCaptured    ->onViewDragStateChanged    ->onEdgeTouchedMOVE:    ->STATE==DRAGGING:dragTo    ->STATE!=DRAGGING:        onEdgeDragStarted        ->getOrderedChildIndex(findTopChildUnder)        ->getViewHorizontalDragRange&          getViewVerticalDragRange(checkTouchSlop)        ->tryCaptureView        ->onViewCaptured        ->onViewDragStateChanged

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

从上面也可以解释，我们在之前TextView(clickable=false)的情况下，没有编写getViewHorizontalDragRange方法时，是可以移动的。因为直接进入processTouchEvent的DOWN，然后就onViewCaptured、onViewDragStateChanged（进入DRAGGING状态），接下来MOVE就直接dragTo了。

而当子View消耗事件的时候，就需要走shouldInterceptTouchEvent，MOVE的时候经过一系列的判断（getViewHorizontalDragRange，clampViewPositionVertical等），才能够去tryCaptureView。

本文转载【鸿洋博客】感谢分享
http://blog.csdn.net/lmj623565791/article/details/46858663

源码下载：

http://download.csdn.net/detail/huang3513/9740400