Android-->ViewDragHelper的详细使用方法

ViewDragHelper是Android系统原生封装用于ViewGroup滑动的类库.(ViewDragHelper只能用在ViewGroup中.)

使用ViewDragHelper,可以非常方便的在ViewGroup中移动,滑动任意一个子View,并且控制相当方便.

1:基础代码模版

public class ViewDragTestLayout extends RelativeLayout {
    ViewDragHelper mViewDragHelper;
    @Override
    protected void onAttachedToWindow() {
        super.onAttachedToWindow();
        //中间参数表示灵敏度,比如滑动了多少像素才视为触发了滑动.值越大越灵敏.
        mViewDragHelper = ViewDragHelper.create(this, 1f, new DragCallback());
    }
    @Override
    public boolean onInterceptTouchEvent(MotionEvent ev) {
        //固定写法
        int action = MotionEventCompat.getActionMasked(ev);
        if (action == MotionEvent.ACTION_CANCEL 
        || action == MotionEvent.ACTION_UP) {
            mViewDragHelper.cancel();
            return false;
        }
        return mViewDragHelper.shouldInterceptTouchEvent(ev);
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        //固定写法
        mViewDragHelper.processTouchEvent(event);
        return true;
    }

    @Override
    public void computeScroll() {
        //固定写法
        //此方法用于自动滚动,比如自动回滚到默认位置.
        if (mViewDragHelper.continueSettling(true)) {
            ViewCompat.postInvalidateOnAnimation(this);
        }
    }
}

以上代码,可以粘贴复制. 都是模版代码;

2:ViewDragHelper.Callback

//这个类的回调方法,才是ViewDragHelper的重点
private class ViewDragCallback extends ViewDragHelper.Callback{

   @Override
   public boolean tryCaptureView(View child, int pointerId) {
       //child 表示想要滑动的view
       //pointerId 表示触摸点的id, 比如多点按压的那个id
       //返回值表示,是否可以capture,也就是是否可以滑动.可以根据不同的child决定是否可以滑动
       return true;
   }

   @Override
   public int clampViewPositionHorizontal(View child, int left, int dx) {
       //child 表示当前正在移动的view
       //left 表示当前的view正要移动到左边距为left的地方
       //dx 表示和上一次滑动的距离间隔
       //返回值就是child要移动的目标位置.可以通过控制返回值,从而控制child只能在ViewGroup的范围中移动.
       return left;
   }

   @Override
   public int clampViewPositionVertical(View child, int top, int dy) {
       //child 表示当前正在移动的view
       //top 表示当前的view正要移动到上边距为top的地方
       //dx 表示和上一次滑动的距离间隔
       return top;
   }
}

重写以上3个方法, 你的ViewGroup就可以正常工作了.子View就可以被任意拖动了.

3:控制child的移动范围在父view中

//控制child只能在ViewGroup的横向中移动
@Override  
public int clampViewPositionHorizontal(View child, int left, int dx) {
  final int leftBound = getPaddingLeft();  
  final int rightBound = getWidth() - mDragView.getWidth();  
  final int newLeft = Math.min(Math.max(left, leftBound), rightBound);  
  return newLeft;  
} 

//控制child只能在ViewGroup的纵向中移动
@Override  
public int clampViewPositionVertical(View child, int top, int dy) {  
  final int topBound = getPaddingTop();  
  final int bottomBound = getHeight() - mDragView.getHeight();  
  final int newTop = Math.min(Math.max(top, topBound), bottomBound);  
  return newTop;  
}

回调顺序

//一次滑动周期的回调顺序.(开始拖动到放手)
getOrderedChildIndex - 0
getOrderedChildIndex - 0
tryCaptureView - tryCaptureView -1 0
onViewCaptured - null
onViewDragStateChanged - null
clampViewPositionHorizontal - left:11 dx:11
clampViewPositionVertical - top:5 dy:5
onViewPositionChanged - null
...
clampViewPositionHorizontal - left:100 dx:23
clampViewPositionVertical - top:44 dy:11
onViewPositionChanged - null
onViewReleased - null
onViewDragStateChanged - null

4:开启边界滑动

//开启4个边
mViewDragHelper.setEdgeTrackingEnabled(ViewDragHelper.EDGE_ALL);
//各个边
public static final int EDGE_LEFT = 1 << 0;
public static final int EDGE_RIGHT = 1 << 1;
public static final int EDGE_TOP = 1 << 2;
public static final int EDGE_BOTTOM = 1 << 3;

//当开启边界滑动之后, 此方法就会回调
@Override
public void onEdgeTouched(int edgeFlags, int pointerId) {
    //通常开启边界之后, 都需要手动capture view.之后就可以滑动view了.
    mViewDragHelper.captureChildView(getChildAt(1), pointerId);
}

@Override
public boolean tryCaptureView(View child, int pointerId) {
    //开启边界之后, 这个方法的返回值可能需要进一步处理.要不然开边界就没啥意思了.
    return false;
}

回调顺序:

getOrderedChildIndex - 2
onEdgeTouched - edgeFlags:4 pointerId:0
getOrderedChildIndex - 2
tryCaptureView - tryCaptureView -1 0
...

5:释放后的回弹效果
有些时候, 当释放的时候, 需要将View回到原来的位置.

//释放的时候, 会回调下面的方法
@Override
public void onViewReleased(View releasedChild, float xvel, float yvel) {
    //调用这个方法,就可以设置releasedChild回弹得位置.
    mViewDragHelper.settleCapturedViewAt(0, 100);//参数就是x,y的坐标
    postInvalidate();//注意一定要调用这个方法,否则没效果.
}

//以下2个方法最终调用的都是forceSettleCapturedViewAt().
mViewDragHelper.settleCapturedViewAt(0, 100);
mViewDragHelper.smoothSlideViewTo(getChildAt(1), 0, 100);
//所以...发挥你的想象力,看看有什么妙用!!!


//如果你还没有忘记的话...前文应该有说过,涉及到scroll,需要重写view的此方法.
//此方法一定要重写,否则没效果
@Override
public void computeScroll() {
  //固定写法
  if (mViewDragHelper.continueSettling(true)) {
      postInvalidate();//注意此处.
  }
}

通过上面2个方法的设置, 当手指释放的时候, View就会自动滑动到指定的位置...(不是一下子就到指定的位置哦,有一个滑动的过程.)

注意:如果需要滑动的View,会消耗touch事件,比如:Button,那么需要重写以下方法.

@Override
public int getViewHorizontalDragRange(View child) {
    return child.getMeasuredWidth();//只要返回大于0的值就行
}

@Override
public int getViewVerticalDragRange(View child) {
    return child.getMeasuredHeight();//只要返回大于0的值就行
}

到这里, 就结束啦...

至此: 文章就结束了,如有疑问: QQ群:274306954 欢迎您的加入.

Android-->ViewDragHelper的详细使用方法

推荐阅读更多精彩内容