Android拖拽辅助类ViewDragHelper的使用说明

1.先看一下如何构造一个ViewDragHelper:

  
    public static ViewDragHelper create(@NonNull ViewGroup forParent, @NonNull ViewDragHelper.Callback cb) {
        return new ViewDragHelper(forParent.getContext(), forParent, cb);
    }

    public static ViewDragHelper create(@NonNull ViewGroup forParent, float sensitivity, @NonNull ViewDragHelper.Callback cb) {
        ViewDragHelper helper = create(forParent, cb);
        helper.mTouchSlop = (int)((float)helper.mTouchSlop * (1.0F / sensitivity));
        return helper;
    }
    
    
    
    private ViewDragHelper(@NonNull Context context, @NonNull ViewGroup forParent, @NonNull ViewDragHelper.Callback cb) {
                    //获取触发移动的最小距离
            this.mTouchSlop = vc.getScaledTouchSlop();
                        //构造OverScroller
            this.mScroller = new OverScroller(context, sInterpolator);
       
    }

ViewDragHelper的构造是私有的,是通过create()构造对象的。

它有2个create(),第一个传入了parent,也就是使用ViewDragHelper的View本身,第二个是Callback。然后默认调用第二个create(),第二个多了一个参数sensitivity,这个sensitivity是用来设置mTouchSlop的,它值越大mTouchSlop就会越小,就会越敏感,也就是滑动的时候判断move的间距越短。

create()最后调用了构造,可以在构造方法中看到初始化了一个OverScroller,可以判断ViewDragHelper的滑动计算等操作也是通过OverScroller计算的(参考:Android中Scroller的使用及原理解析)

2. 再看一下ViewDragHelper的Callback

 public abstract static class Callback {
        public Callback() {
        }
                //View的拖拽状态改变时触发
        //STATE_IDLE: 未被拖拽
        //STATE_DRAGGING:正在被拖拽
        //STATE_SETTLING: 被安放到一个位置中的状态
        public void onViewDragStateChanged(int state) {
        }
                //拖拽时的(开始移动)触发
        //changeView:当前被拖拽的view
        //left:拖动时left坐标
        //top:拖动时top坐标
        //dx:拖拽时x轴偏移量
        //dy:拖拽时y轴偏移量
        public void onViewPositionChanged(@NonNull View changedView, int left, int top, @Px int dx, @Px int dy) {
        }
                //view被捕获时触发(也就是按下)
        //capturedChild:捕获的view
        //activePointerId:按下手指的id,多指触控时会用到
        //一般用于做准备初始化工作
        public void onViewCaptured(@NonNull View capturedChild, int activePointerId) {
        }
                //view被放下时触发
        //releasedChild被放下的view
        //xvel:释放View的x轴方向上的加速度
        //yvel:释放View的y轴方向上的加速度
        //一般用于收尾工作
        public void onViewReleased(@NonNull View releasedChild, float xvel, float yvel) {
        }
                //边缘触摸时触发(需开启边缘触摸)
        //edgeFlags:触摸的位置EDGE_LEFT,EDGE_TOP,EDGE_RIGHT,EDGE_BOTTOM
            //pointerId: 按下手指的id,多指触控时会用到
        //使用较少,一般不重写
        public void onEdgeTouched(int edgeFlags, int pointerId) {
        }
                //是否开启边缘触摸,true代表开启,默认不开启
        //edgeFlags:触摸的位置EDGE_LEFT,EDGE_TOP,EDGE_RIGHT,EDGE_BOTTOM
       //使用较少,一般不重写
        public boolean onEdgeLock(int edgeFlags) {
            return false;
        }
                //边缘触摸时触发(需开启边缘触摸)
        //edgeFlags:触摸的位置EDGE_LEFT,EDGE_TOP,EDGE_RIGHT,EDGE_BOTTOM
            //pointerId: 按下手指的id,多指触控时会用到
        //使用较少,一般不重写
        public void onEdgeDragStarted(int edgeFlags, int pointerId) {
        }
                //寻找当前触摸点下的子View时会调用此方法,寻找到的View会提供给tryCaptureViewForDrag()来尝试捕获。
        //如果需要改变子View的遍历查询顺序可改写此方法,例如让下层的View优先于上层的View被选中。
        //使用较少,一般不重写
        public int getOrderedChildIndex(int index) {
            return index;
        }
                //暂不明确(返回任何值都可以移动,网上说的都是错的)
       //使用较少,一般不重写
        public int getViewHorizontalDragRange(@NonNull View child) {
            return 0;
        }
                //暂不明确(返回任何值都可以移动,网上说的都是错的)
        //使用较少,一般不重写
        public int getViewVerticalDragRange(@NonNull View child) {
            return 0;
        }
                //尝试捕获被拖拽的view,如果返回true代表可以被拖拽,返回false代表不可以被拖拽
        //var1:被拖拽的view
        //使用时判断需要被拖拽的view是否等等于var1。
        //一般判断很多view其中哪些是否可以移动时使用
        public abstract boolean tryCaptureView(@NonNull View var1, int var2);
                //返回view在水平方向的位置,
        //left:当前被拖拽的的view要移动到的的left值
        //dx:移动的偏移量
        //返回0则无法移动,通常直接返回left
        //一般必须重写此方法返回left
        public int clampViewPositionHorizontal(@NonNull View child, int left, int dx) {
            return 0;
        }
      
        //返回view在竖直方向的位置,
        //top:当前被拖拽的的view要移动到的的left值
        //dy:移动的偏移量
        //返回0则无法移动,通常直接返回top
        //一般必须重写此方法返回top
        public int clampViewPositionVertical(@NonNull View child, int top, int dy) {
            return 0;
        }
    }

3. ViewDragHelper的使用

  • 先看一下常用到的方法
//以松手前的滑动速度为初速动,让捕获到的View自动滚动到指定位置。只能在Callback的onViewReleased()中调用。
settleCapturedViewAt(int finalLeft, int finalTop)
//以松手前的滑动速度为初速动,让捕获到的View在指定范围内fling。只能在Callback的onViewReleased()中调用。
flingCapturedView(int minLeft, int minTop, int maxLeft, int maxTop)
//指定某个View自动滚动到指定的位置,初速度为0,可在任何地方调用。
smoothSlideViewTo(View child, int finalLeft, int finalTop)
  • 再看使用:
    初始化并重写需要用到的方法:
 viewDragHelper=  ViewDragHelper.create(this, new ViewDragHelper.Callback() {
            @Override
            public boolean tryCaptureView(@NonNull View view, int i) {

                return true;
            }

            @Override
            public int clampViewPositionHorizontal(@NonNull View child, int left, int dx) {
               return left;
           }

            @Override
            public int clampViewPositionVertical(@NonNull View child, int top, int dy) {
                return top;
            }

           @Override
           public void onViewReleased(@NonNull View releasedChild, float xvel, float yvel) {
               super.onViewReleased(releasedChild, xvel, yvel);
                            super.onViewReleased(releasedChild, xvel, yvel);
                    //让捕获到的View自动滚动到100,300位置,只能在这里使用这个方法
               viewDragHelper.settleCapturedViewAt(100,300);
                 //让捕获到的View在100,100,500,500这个范围内fling  ,只能在这里使用这个方法
               viewDragHelper.flingCapturedView(100,100,500,500);
               //指定某个View自动滚动到500,500,初速度为0,可在任何地方调用。 
               viewDragHelper.smoothSlideViewTo(releasedChild,500,500);
               //以上方法必须手动去刷新页面
                             invalidate();
           }

       });


以上四个为常用的方法,然后获取事件权限:

    @Override
    public boolean onInterceptHoverEvent(MotionEvent event) {
        return viewDragHelper.shouldInterceptTouchEvent(event);
    }

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

    }

之前说了,ViewDragHelper内部是overScroller完成计算的,那么和overScroller一样需要重写computeScroll()一直刷新页面:

    @Override
    public void computeScroll() {
        super.computeScroll();
        //使用continueSettling(true)判断拖拽是否完成
        if (viewDragHelper.continueSettling(true)){
            invalidate();
        }
    }

你可能感兴趣的:(Android拖拽辅助类ViewDragHelper的使用说明)