ViewDragHelper详解（一）- 可拖动的view

ViewDragHelper从名称上就可以看出， 这是一个用来简化view拖拽操作的帮助类。而且使用起来也很简单， 很方便，只需要几个方法和1个Callback就可以实现一个可以拖动到view。

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

如何使用ViewGroup实现一个可以拖动的view？

1、获取ViewDragHelper的实例，注意，这里不能直接new，而是使用ViewDragHelper的一个静态方法：

ViewDragHelper.create(ViewGroup forParent, float sensitivity, ViewDragHelper.Callback cb);

参数1： 一个ViewGroup， 也就是ViewDragHelper将要用来拖拽谁下面的子view

参数2：灵敏度，一般设置为1.0f就行

参数3：一个回调，用来处理拖动到位置

2、继承ViewDragHelper.Callback类，该类有个抽象方法：tryCaptureView(View view, int pointerId) 表示尝试捕获子view，这里一定要返回true， 返回true表示允许。

3、重写两个方法int clampViewPositionHorizontal(View child, int left, int dx)和int clampViewPositionHorizontal(View child, int left, int dx) 这两个方法分别用来处理x方向和y方向的拖动的，返回值该child现在的位置。

4、重写ViewGroup的onInterceptTouchEvent(MotionEvent ev)用来拦截事件

5、重写ViewGroup的onTouchEvent(MotionEvent event) 在这里面只要做两件事：mDragHelper.processTouchEvent(event);处理拦截到的事件，这个方法会在返回前分发事件；return true 表示消费了事件。

简单的5步就可以实现一个可以任意拖动到view了，当然我们需要在clampViewPositionHorizontal和clampViewPositionHorizontal中做一点工作，以防止view超出了边界。

详细代码(详细说明都在代码的注释中)：

public class CustomView extends LinearLayout {
	private ViewDragHelper mDragHelper;

	public CustomView(Context context) {
		super(context);
		init();
	}

	public CustomView(Context context, AttributeSet attrs) {
		super(context, attrs);
		init();
	}

	public CustomView(Context context, AttributeSet attrs, int defStyle) {
		super(context, attrs, defStyle);
		init();
	}

	private void init() {
		/**
		 * @params ViewGroup forParent 必须是一个ViewGroup
		 * @params float sensitivity 灵敏度
		 * @params Callback cb 回调
		 */
		mDragHelper = ViewDragHelper.create(this, 1.0f, new ViewDragCallback());
	}
	
	private class ViewDragCallback extends ViewDragHelper.Callback {
		/**
		 * 尝试捕获子view，一定要返回true
		 * @param View child 尝试捕获的view
		 * @param int pointerId 指示器id？ 
		 * 这里可以决定哪个子view可以拖动
		 */
		@Override
		public boolean tryCaptureView(View view, int pointerId) {
//			return mCanDragView == view;
			return true;
		}
		
		/**
		 * 处理水平方向上的拖动
		 * @param View child 被拖动到view
		 * @param int left 移动到达的x轴的距离
		 * @param int dx 建议的移动的x距离
		 */
		@Override
		public int clampViewPositionHorizontal(View child, int left, int dx) {
			System.out.println("left = " + left + ", dx = " + dx);
			
			// 两个if主要是为了让viewViewGroup里
			if(getPaddingLeft() > left) {
				return getPaddingLeft();
			}
			
			if(getWidth() - child.getWidth() < left) {
				return getWidth() - child.getWidth();
			}
			
			return left;
		}
		
		/**
		 *  处理竖直方向上的拖动
		 * @param View child 被拖动到view
		 * @param int top 移动到达的y轴的距离
		 * @param int dy 建议的移动的y距离
		 */
		@Override
		public int clampViewPositionVertical(View child, int top, int dy) {
			// 两个if主要是为了让viewViewGroup里
			if(getPaddingTop() > top) {
				return getPaddingTop();
			}
			
			if(getHeight() - child.getHeight() < top) {
				return getHeight() - child.getHeight();
			}
			
			return top;
		}
		
		/**
		 * 当拖拽到状态改变时回调
		 * @params 新的状态
		 */
		@Override
		public void onViewDragStateChanged(int state) {
			switch (state) {
			case ViewDragHelper.STATE_DRAGGING:  // 正在被拖动
				break;
			case ViewDragHelper.STATE_IDLE:  // view没有被拖拽或者 正在进行fling/snap
				break;
			case ViewDragHelper.STATE_SETTLING: // fling完毕后被放置到一个位置
				break;
			}
			super.onViewDragStateChanged(state);
		}
	}
	
	@Override
	public boolean onInterceptTouchEvent(MotionEvent ev) {
		switch (ev.getAction()) {
		case MotionEvent.ACTION_CANCEL:
		case MotionEvent.ACTION_DOWN:
			mDragHelper.cancel(); // 相当于调用 processTouchEvent收到ACTION_CANCEL
			break;
		}
		
		/**
		 * 检查是否可以拦截touch事件
		 * 如果onInterceptTouchEvent可以return true 则这里return true
		 */
		return mDragHelper.shouldInterceptTouchEvent(ev);
	}
	
	@Override
	public boolean onTouchEvent(MotionEvent event) {
		/**
		 * 处理拦截到的事件
		 * 这个方法会在返回前分发事件
		 */
		mDragHelper.processTouchEvent(event);
		return true;
	}
}

在xml中使用：

<RelativeLayout 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:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context=".MainActivity" >

    <org.loader.viewdraghelpertest1.CustomView
        android:layout_width="match_parent"
        android:layout_height="match_parent">
        <View
            android:layout_width="100dp"
            android:layout_height="100dp"
            android:background="#FFFF0000" />
    </org.loader.viewdraghelpertest1.CustomView>

</RelativeLayout>

看一下效果吧：