自定义控件辅助神器ViewDragHelper

原创 2016年08月28日 20:27:39

ViewDragHelper

ViewDragHelper作为官方推出的手势滑动辅助工具,极大的简化了我们对手势滑动的处理逻辑,v4包中的SlidingPaneLayout和DrawerLayout内部都有ViewDragHelper的身影,这里对这个强大的辅助工具类使用以及相关方法做个系统性的总结。
全文思路:

一、用ViewDragHelper实现一个简单效果,并对ViewDragHelper使用的常见思路进行总结
二、对ViewDragHelper相关API进行归纳分析
1、ViewDragHelper
2、ViewDragHelper.CallBack

一、用ViewDragHelper实现一个简单的效果,对其有个初步的认识

用个在项目中实现的简单效果来看下吧:

ViewDragHelper

这个实现思路也很简单,我们看下代码:

public class MyDragViewLayout extends ViewGroup{
     public ViewDragHelper mViewDragHelper;
     private boolean isOpen = true;
     private View mMenuView;
     private View mContentView;
     private int mCurrentTop = 0;
      public MyDragViewLayout(Context context) {
            super(context);
            init();
        }

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

        public MyDragViewLayout(Context context, AttributeSet attrs, int defStyleAttr) {
            super(context, attrs, defStyleAttr);
            init();
        }
        private void init() {
            //ViewDragHelper静态方法传入ViewDragHelperCallBack创建
            mViewDragHelper = ViewDragHelper.create(this, 1.0f, new ViewDragHelperCallBack());
//          mViewDragHelper.setEdgeTrackingEnabled(ViewDragHelper.EDGE_TOP);
        }
      //实现ViewDragHelper.Callback相关方法
        private class ViewDragHelperCallBack extends ViewDragHelper.Callback {
            @Override
            public boolean tryCaptureView(View child, int pointerId) {
                //返回ture则表示可以捕获该view
                return child == mContentView;
            }

            @Override
            public void onEdgeDragStarted(int edgeFlags, int pointerId) {
                //setEdgeTrackingEnabled设置的边界滑动时触发
                //通过captureChildView对其进行捕获,该方法可以绕过tryCaptureView

                //mViewDragHelper.captureChildView(mContentView, pointerId);
            }

            @Override
            public int clampViewPositionHorizontal(View child, int left, int dx) {
                //手指触摸移动时回调, left表示要到的x坐标
                return super.clampViewPositionHorizontal(child, left, dx);//
            }

            @Override
            public int clampViewPositionVertical(View child, int top, int dy) {
                //手指触摸移动时回调 top表示要到达的y坐标
                return Math.max(Math.min(top, mMenuView.getHeight()), 0);
            }

            @Override
            public void onViewReleased(View releasedChild, float xvel, float yvel) {
                //手指抬起释放时回调
                int finalTop = mMenuView.getHeight();
                if(yvel <= 0){
                    if(releasedChild.getTop()< mMenuView.getHeight()/2){
                        finalTop = 0;
                    }else{
                        finalTop = mMenuView.getHeight();
                    }
                }else{
                    if(releasedChild.getTop() > mMenuView.getHeight()/2){
                        finalTop = mMenuView.getHeight();
                    }else{
                        finalTop = 0;
                    }
                }
                mViewDragHelper.settleCapturedViewAt(releasedChild.getLeft(), finalTop);
                invalidate();
            }

            @Override
            public void onViewPositionChanged(View changedView, int left, int top, int dx, int dy) {
                //mDrawerView完全覆盖屏幕则防止过度绘制
                mMenuView.setVisibility((changedView.getHeight() - top == getHeight()) ? View.GONE : View.VISIBLE);
                mCurrentTop +=dy;
                requestLayout();
            }
            @Override
            public int getViewVerticalDragRange(View child) {
                if (mMenuView == null) return 0;
                return (mContentView == child) ? mMenuView.getHeight() : 0;
            }

            @Override
            public void onViewDragStateChanged(int state) {
                super.onViewDragStateChanged(state);
                if (state == ViewDragHelper.STATE_IDLE) {
                    isOpen = (mContentView.getTop() == mMenuView.getHeight());
                }
            }
        }
        @Override
        public void computeScroll() {
            if (mViewDragHelper.continueSettling(true)) {
                invalidate();
            }
        }
        public boolean isDrawerOpened() {
            return isOpen;
        }
      //onInterceptTouchEvent方法调用ViewDragHelper.shouldInterceptTouchEvent
        @Override
        public boolean onInterceptTouchEvent(MotionEvent ev) {
            return mViewDragHelper.shouldInterceptTouchEvent(ev);
        }

        //onTouchEvent方法中调用ViewDragHelper.processTouchEvent方法并返回true
        @Override
        public boolean onTouchEvent(MotionEvent event) {
            mViewDragHelper.processTouchEvent(event);
            return true;
        }

        @Override
        protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
            int measureWidth = MeasureSpec.getSize(widthMeasureSpec);
            int measureHeight = MeasureSpec.getSize(heightMeasureSpec);
            setMeasuredDimension(measureWidth, measureHeight);

            measureChildren(widthMeasureSpec, heightMeasureSpec);
        }

    @Override
    protected void onFinishInflate() {
        super.onFinishInflate();
        mMenuView = getChildAt(0);
        mContentView = getChildAt(1);
    }

    @Override
        protected void onLayout(boolean changed, int l, int t, int r, int b) {
                    mMenuView.layout(0, 0,
                            mMenuView.getMeasuredWidth(),
                            mMenuView.getMeasuredHeight());
                    mContentView.layout(0, mCurrentTop + mMenuView.getHeight(),
                            mContentView.getMeasuredWidth(),
                            mCurrentTop + mContentView.getMeasuredHeight() + mMenuView.getHeight());

        }
}

xml:

<?xml version="1.0" encoding="utf-8"?>
<com.mrzk.myapplication.MyDragViewLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:layout_width="match_parent"
              android:layout_height="match_parent">
    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="300dp"
        android:background="?attr/colorAccent">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Menu"
            android:layout_centerInParent="true"
            android:textSize="22sp"
            android:textColor="#fff"/>
    </RelativeLayout>

    <RelativeLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="?attr/colorPrimary">

        <TextView
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:gravity="center"
            android:text="Content"
            android:textSize="22sp"
            android:textColor="#fff"/>
    </RelativeLayout>
</com.mrzk.myapplication.MyDragViewLayout>

我们缕一下思路,

第一步:在init方法中用ViewDragHelper的静态方法实例化ViewDragHelper对象,其中第一个参数指的当前的ViewGroup,第二个sensitivity参数指的是对滑动检测的敏感度,越大越敏感,默认传1即可。第三个参数为静态回调对象CallBack,我们实现相关CallBack方法来操作拖拽的View。
第二步:实现ViewDragHelper.Callback的相关方法。
第三步:在onInterceptTouchEvent方法中调用mViewDragHelper.shouldInterceptTouchEvent(ev)将事件传给ViewDragHelper。
第四步:在onTouchEvent方法中调用ViewDragHelper.processTouchEvent方法并返回true。

二、对ViewDragHelper相关API进行归纳分析

1、ViewDragHelper
ViewDragHelper方法

public static ViewDragHelper create(ViewGroup forParent, float sensitivity, Callback cb)
sensitivity越大,对滑动的检测就越敏感,默认传1即可

public void setEdgeTrackingEnabled(int edgeFlags)
设置允许父View的某个边缘可以用来响应托拽事件,

public boolean shouldInterceptTouchEvent(MotionEvent ev)
在父view onInterceptTouchEvent方法中调用

public void processTouchEvent(MotionEvent ev)
在父view onTouchEvent方法中调用

public void captureChildView(View childView, int activePointerId)
在父View内捕获指定的子view用于拖曳,会回调tryCaptureView()

public boolean smoothSlideViewTo(View child, int finalLeft, int finalTop)
某个View自动滚动到指定的位置,初速度为0,可在任何地方调用,动画移动会回调continueSettling(boolean)方法,直到结束

public boolean settleCapturedViewAt(int finalLeft, int finalTop)
以松手前的滑动速度为初值,让捕获到的子View自动滚动到指定位置,只能在Callback的onViewReleased()中使用,其余同上

public void flingCapturedView(int minLeft, int minTop, int maxLeft, int maxTop)
以松手前的滑动速度为初值,让捕获到的子View在指定范围内fling惯性运动,只能在Callback的onViewReleased()中使用,其余同上

public boolean continueSettling(boolean deferCallbacks)
在调用settleCapturedViewAt()、flingCapturedView()和smoothSlideViewTo()时,该方法返回true,一般重写父view的computeScroll方法,进行该方法判断

public void abort()
中断动画

ViewDragHelper的滑动中共有三个方法可以调用,smoothSlideViewTosettleCapturedViewAtflingCapturedView,动画移动会回调continueSettling(boolean)方法,在内部是用的ScrollerCompat来实现滑动的。
在computeScroll方法中判断continueSettling(boolean)的返回值,来动态刷新界面:

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

2、ViewDragHelper.CallBack

CallBack方法

public void onViewPositionChanged(View changedView, int left, int top, int dx, int dy)
被拖拽的View位置变化时回调,changedView为位置变化的view,left、top变化后的x、y坐标,dx、dy为新位置与旧位置的偏移量

public void onViewDragStateChanged(int state)
当ViewDragHelper状态发生变化时回调(STATE_IDLE,STATE_DRAGGING,STATE_SETTLING)

public void onViewCaptured(View capturedChild, int activePointerId)
成功捕获到子View时或者手动调用captureChildView()时回调

public void onViewReleased(View releasedChild, float xvel, float yvel)
当前拖拽的view松手或者ACTION_CANCEL时调用,xvel、yvel为离开屏幕时的速率

public void onEdgeTouched(int edgeFlags, int pointerId)
当触摸到边界时回调

public boolean onEdgeLock(int edgeFlags)
true的时候会锁住当前的边界,false则unLock。锁定后的边缘就不会回调onEdgeDragStarted()

public void onEdgeDragStarted(int edgeFlags, int pointerId)
ACTION_MOVE且没有锁定边缘时触发,在此可手动调用captureChildView()触发从边缘拖动子View

public int getOrderedChildIndex(int index)
寻找当前触摸点View时回调此方法,如需改变遍历子view顺序可重写此方法

public int getViewHorizontalDragRange(View child)
返回拖拽子View在相应方向上可以被拖动的最远距离,默认为0

public int getViewVerticalDragRange(View child)
返回拖拽子View在相应方向上可以被拖动的最远距离,默认为0

public abstract boolean tryCaptureView(View child, int pointerId)
对触摸view判断,如果需要当前触摸的子View进行拖拽移动就返回true,否则返回false

public int clampViewPositionHorizontal(View child, int left, int dx)
拖拽的子View在所属方向上移动的位置,child为拖拽的子View,left为子view应该到达的x坐标,dx为挪动差值

public int clampViewPositionVertical(View child, int top, int dy)
同上,top为子view应该到达的y坐标

版权声明:本文为博主原创文章,未经博主允许不得转载。

相关文章推荐

ViewDragHelper实战 自己打造Drawerlayout

转载请标明出处: http://blog.csdn.net/lmj623565791/article/details/47396187; 本文出自:【张鸿洋的博客】 一、概述 在上一...

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

转载请标明出处: http://blog.csdn.net/lmj623565791/article/details/46858663; 本文出自:【张鸿洋的博客】 一、概述在自定义Vie...

强大的ViewDragHelper和ViewDragHelper的妙用 一

文如其名,本篇博文我们将详细介绍强大的ViewDragHelper,但是这次我们将他们分开,本篇我们将完全解析 ViewDragHelper,下一篇我们我们将系统的说明ViewDragHelper的妙...

神奇的 ViewDragHelper,让你轻松定制拥有拖拽能力的 ViewGroup

为了吸引大家的注意力,先给大家看一张动图: 相信这种效果大家都见过吧?我第一次见到这样的效果时,心里也痒痒的,急于想实现这种功能,后来因为拖延症的问题,就一直没有去弄这件事。现在这段时间,工作比...
  • briblue
  • briblue
  • 2017年06月25日 22:33
  • 3491

Android ViewDragHelper及移动处理总结

概述2013年谷歌i/o大会上介绍了两个新的layout: SlidingPaneLayout和DrawerLayout,现在这俩个类被广泛的运用。我们知道在我们实际的开发中往往会涉及到很多的拖动效果...

Android应用ViewDragHelper详解及部分源码浅析

自定义ViewGroup里通过ViewDragHelper静态工厂方法create()创建实例并实现ViewDragHelper.CallBack抽象类。在自定义ViewGroup的onInterce...
  • yanbober
  • yanbober
  • 2016年01月03日 18:51
  • 13630

ViewDragHelper(二)- 源码及原理解读(进阶篇)

本篇为该系列的第二篇,侧重讲解ViewDragHelper 的实现原理和源码逻辑,以及它所提供给我们的一些方法。目录ViewDragHelper 的介绍以及初步使用请阅读这篇: ViewDragHe...

Android 神器ViewDragHelper(实战二)

前言: 很久以前就在以前前辈的项目中用到一个控件叫BounceScrollView,那个时候觉得有点高大上的感觉,就是可以上下弹性拉动的ScrollView,也就是仿ios那种效果,一直想去研究一下,...
  • vv_bug
  • vv_bug
  • 2016年11月06日 16:17
  • 774

ViewDragHelper详解

[置顶] ViewDragHelper详解 分类: android2014-09-16 12:10 304人阅读 评论(3) 收藏 举报 android    2013年...
  • pi9nc
  • pi9nc
  • 2014年09月26日 17:25
  • 33537

为何说Android ViewDragHelper是神器 (实战)

前言: 前面写了两篇关于ViewDragHelper的博客了,自我感觉收获了挺多知识的,光说不敲还是不行的,所以准备结合项目的例子写一篇关于VDH的实战篇。 项目需求: 做到跟ios一样的效果,滑动...
  • vv_bug
  • vv_bug
  • 2016年11月07日 17:39
  • 535
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:自定义控件辅助神器ViewDragHelper
举报原因:
原因补充:

(最多只允许输入30个字)