下面记录下自己对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