ViewDragerHelper(一)认识与简单实现

96
前世小书童
0.3 2016.04.27 18:29* 字数 955

前言

<p>
ViewDrager是什么呢?

看看官方的解释其实就明白了

/**
 * 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.
 */

从这段解释呢我们可以看到ViewDrager是简化view拖拽操作的帮助类,ViewDragHelper解决了android中手势处理过于复杂的问题。

ViewDragHelper是作用在一个ViewGroup上,也就是说他不能直接作用到被拖拽的view, 其实这也很好理解,因为view在布局中的位置是父ViewGroup决定的。

简单实现

<p>
接下来就实现一个内部View随意拖动的demo

分步来完成

1.自定义一个ViewGroup

public class VDHLayout extends LinearLayout{
    
     public VDHLayout(Context context) {
        this(context, null);
    }

    public VDHLayout(Context context, AttributeSet attrs) {
        this(context, attrs, 0);
    }

    public VDHLayout(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
    }
    
}

2.创建ViewDragerHelper实例以及实现ViewDragHelper.CallCack相关方法

 private ViewDragHelper viewDragHelper;

 private void initViewDragHelper(){
        viewDragHelper = ViewDragHelper.create(this,myCallBack);
        viewDragHelper.setEdgeTrackingEnabled(ViewDragHelper.EDGE_ALL);
    }

ViewDragHelper.Callback myCallBack = 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;
    }
};

3.触摸相关方法

@Override
public boolean onInterceptTouchEvent(MotionEvent ev) {
    return viewDragHelper.shouldInterceptTouchEvent(ev);
}

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

布局内容就不贴上来了

最后实现的效果如下

图1 ViewDragerHelper简单demo

是不是很神奇,简单的几行代码就实现了这样的效果了,至于为什么会实现呢?

这个到下一篇再从源码角度进行说明

接下来我们看看ViewDragHelper.CallCack里的方法,这里面的方法则是ViewDragHelper实现不同效果和功能的主要地方

ViewDragHelper.CallCack

<p>
ViewDragHelper.CallCack里面的方法很多,分别介绍

  • onViewDragStateChanged(int state)

    当View的拖拽状态改变时的回调
    STATE_IDLE: 当前未被拖拽
    STATE_DRAGGING:正在被拖拽
    STATE_SETTLING: 被拖拽后需要被安放到一个位置中的状态

  • onViewPositionChanged(View changedView, int left, int top, int dx, int dy)

    当View拖拽位置发生变化时的回调
    changedView :被拖拽的View
    left : 被拖拽后View的left边缘坐标
    top : 被拖拽后View的top边缘坐标
    dx : 拖动的x偏移量
    dy : 拖动的y偏移量

  • onViewCaptured(View capturedChild, int activePointerId)

当一个View捕获到准备拖拽时的回调
capturedChild : 捕获的View
activePointerId: 对应的PointerId

  • onViewReleased(View releasedChild, float xvel, float yvel)

    当被捕获拖拽View释放的回调
    releasedChild:被释放的View
    xvel: 释放View的x方向上的加速度
    yvel: 释放View的y方向上的加速度

  • onEdgeTouched(int edgeFlags, int pointerId)

    边缘触摸的回调
    edgeFlags : 当前触摸的flag 有: EDGE_LEFT,EDGE_TOP,EDGE_RIGHT,EDGE_BOTTOM
    pointerId : 用来描述边缘触摸操作的id

  • onEdgeLock(int edgeFlags)

    是否锁定该边缘的触摸,默认返回false,返回true表示锁定

  • onEdgeDragStarted(int edgeFlags, int pointerId)

    边缘触摸开始时的回调
    edgeFlags : 当前触摸的flag 有: EDGE_LEFT,EDGE_TOP,EDGE_RIGHT,EDGE_BOTTOM
    pointerId : 用来描述边缘触摸操作的id

  • getOrderedChildIndex(int index)

    如果需要改变子View的遍历查询顺序可改写此方法,例如让下层的View优先于上层的View被选中。

  • tryCaptureView(View child, int pointerId)

    尝试捕获被拖拽的View
    child : 尝试捕获的View
    pointerId: 对应的PointerId

  • getViewHorizontalDragRange(View child)

    获取被拖拽View child 的水平拖拽范围,返回0表示无法被水平拖拽

  • getViewVerticalDragRange(View child)

    获取被拖拽View child 的垂直拖拽范围,返回0表示无法被垂直拖拽

  • clampViewPositionHorizontal(View child, int left, int dx)

    决定拖拽View在水平方向上应该移动到的位置
    child : 被拖拽的View
    left : 期望移动到位置的View的left值
    dx : 移动的水平距离
    返回值 : 直接决定View在水平方向的位置

  • clampViewPositionVertical(View child, int top, int dy)

    决定拖拽View在垂直方向上应该移动到的位置
    child : 被拖拽的View
    top : 期望移动到位置的View的top值
    dy : 移动的垂直距离
    返回值 : 直接决定View在垂直方向的位置

写在后面的话

<p>
到这里基本上简单使用已经介绍完毕了,对ViewDragHelper.CallCack的方法也都介绍了一遍,对于更深的源码解析和更深层次的使用就放在后面的文章进行分析了。。

日记本