Android ViewDragHelper全然解析自己定义ViewGroup神器

一、概述

在自己定义ViewGroup中。非常多效果都包括用户手指去拖动其内部的某个View(eg:側滑菜单等)，针对详细的须要去写好

onInterceptTouchEvent

和

onTouchEvent

这两个方法是一件非常不easy的事，须要自己去处理：多手指的处理、加速度检測等等。

好在官方在v4的支持包中提供了

ViewDragHelper

这样一个类来帮助我们方便的编写自己定义ViewGroup。

简单看一下它的凝视：

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

的使用。而且终于去实现一个相似

DrawerLayout

的一个自己定义的ViewGroup。（ps:官方的DrawerLayout就是用此类实现）

二、入门小演示样例

首先我们通过一个简单的样例来看看其快捷的使用方法。分为下面几个步骤：

创建实例
触摸相关的方法的调用
ViewDragHelper.Callback实例的编写

(一) 自己定义ViewGroup

package com.zhy.learn.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;

/**
 * Created by zhy on 15/6/3.
 */
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()
        {
            @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;
            }
        });
    }

   @Override
    public boolean onInterceptTouchEvent(MotionEvent event)
    {
        return mDragger.shouldInterceptTouchEvent(event);
    }

    @Override
    public boolean onTouchEvent(MotionEvent event)
    {
        mDragger.processTouchEvent(event);
        return true;
    }
}

能够看到，上面整个自己定义ViewGroup的代码非常简洁，遵循上述3个步骤：

1、创建实例

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

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

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

可见传入越大，mTouchSlop的值就会越小。

第三个參数就是Callback，在用户的触摸过程中会回调相关方法，后面会细说。

2、触摸相关方法

@Override
    public boolean onInterceptTouchEvent(MotionEvent event)
    {
        return mDragger.shouldInterceptTouchEvent(event);
    }

    @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。

简单看一下布局文件

(二) 布局文件

<com.zhy.learn.view.VDHLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:orientation="vertical"
android:layout_height="match_parent"
>

<TextView
android:layout_margin="10dp"
android:gravity="center"
android:layout_gravity="center"
android:background="#44ff0000"
android:text="I can be dragged !"
android:layout_width="100dp"
android:layout_height="100dp"/>

<TextView
android:layout_margin="10dp"
android:layout_gravity="center"
android:gravity="center"
android:background="#44ff0000"
android:text="I can be dragged !"
android:layout_width="100dp"
android:layout_height="100dp"/>

<TextView
android:layout_margin="10dp"
android:layout_gravity="center"
android:gravity="center"
android:background="#44ff0000"
android:text="I can be dragged !"
android:layout_width="100dp"
android:layout_height="100dp"/>

</com.zhy.learn.view.VDHLayout>

我们的自己定义ViewGroup中有三个TextView。

当前效果：

Android ViewDragHelper全然解析自己定义ViewGroup神器

能够看到短短数行代码就能够玩起来了~~~

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

三、功能展示

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

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

那么我们接下来对我们最主要的样例进行改造，包括上述的几个操作。

首先看一下我们改动后的效果：

简单的为每一个子View加入了不同的操作：

第一个View。就是演示简单的移动

第二个View，演示除了移动后。松手自己主动返回到原本的位置。（注意你拖动的越快，返回的越快）

第三个View，边界移动时对View进行捕获。

好了，看完效果图，来看下代码的改动：

改动后的代码

package com.zhy.learn.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;

/**
* Created by zhy on 15/6/3.
*/
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()
        {
@Override
public boolean tryCaptureView(View child, int pointerId)
            {
//mEdgeTrackerView禁止直接移动
return child == mDragView || child == mAutoBackView;
            }

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

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


//手指释放的时候回调
@Override
public void onViewReleased(View releasedChild, float xvel, float yvel)
            {
//mAutoBackView手指释放时能够自己主动回去
if (releasedChild == mAutoBackView)
                {
mDragger.settleCapturedViewAt(mAutoBackOriginPos.x, mAutoBackOriginPos.y);
invalidate();
                }
            }

//在边界拖动时回调
@Override
public void onEdgeDragStarted(int edgeFlags, int pointerId)
            {
mDragger.captureChildView(mEdgeTrackerView, pointerId);
            }
        });
mDragger.setEdgeTrackingEnabled(ViewDragHelper.EDGE_LEFT);
    }


@Override
public boolean onInterceptTouchEvent(MotionEvent event)
    {
return mDragger.shouldInterceptTouchEvent(event);
    }

@Override
public boolean onTouchEvent(MotionEvent event)
    {
mDragger.processTouchEvent(event);
return true;
    }

@Override
public void 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 ，都记得重写下面这两个方法：

@Override
public int getViewHorizontalDragRange(View child)
{
return getMeasuredWidth()-child.getMeasuredWidth();
}

@Override
public 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)
->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，上述是正常情况下大致的流程。当然整个过程可能会存在非常多推断不成立的情况。

从上面也能够解释。我们在之前TextView(clickable=false)的情况下。没有编写getViewHorizontalDragRange方法时，是能够移动的。

由于直接进入processTouchEvent的DOWN。然后就onViewCaptured、onViewDragStateChanged（进入DRAGGING状态），接下来MOVE就直接dragTo了。

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

Android ViewDragHelper全然解析自己定义ViewGroup神器

一、概述

二、入门小演示样例

(一) 自己定义ViewGroup

(二) 布局文件

三、功能展示

继续阅读

UVA 519 Puzzle (II)

Android MVP架构MVCMVP

mvp初探

Android常用工具类简介目录

android常用工具类转载自：http://www.trinea.cn/android/android-common-utils/Android常用工具类

Android常用工具类ToastUtilsSizeUtilsLogUtilsRetrofitManagerAnimUtil

磁盘结构及在Linux中的命名

Android Studio 0.8.0解决 Failure [INSTALL_FAILED_OLDER_SDK] 问题

Android – ListView 中添加按钮，动态删除添加ItemView的操作

Kotlin的ListView与RecyclerView的简单应用

关于公司的那些坑：Android Studio篇

android SQLite事务和kotlin协程

无法正常编译错误Compilation failed to complete

关于Gradle配置的小结

AOP编程_Android优雅权限框架(1)概念基础，2021金三银四前言正文大纲正文

Android APK文件反编译Android APK文件反编译

Android ViewDragHelper全然解析 自己定义ViewGroup神器

一、概述

二、入门小演示样例

(一) 自己定义ViewGroup

(二) 布局文件

三、功能展示

继续阅读

Android ViewDragHelper全然解析自己定义ViewGroup神器