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.具体应用
一下是效果与布局代码

<cn.wsy.viewdraghelper.Views.BasicMoveView 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:orientation="vertical"
   tools:context=".MainActivity">
   <TextView
       android:id="@+id/text1"
       android:layout_width="100dp"
       android:layout_height="100dp"
       android:background="#000000" />
   <TextView
       android:layout_width="100dp"
       android:layout_height="100dp"
       android:background="#ccc" />
   <TextView
       android:layout_width="100dp"
       android:layout_height="100dp"
       android:background="#44ff0000" />
</cn.wsy.viewdraghelper.Views.BasicMoveView>
(二)通过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

    原文作者:DevSiven
    原文地址: https://www.jianshu.com/p/568f2dfa3318
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞