ViewDragHelper API 的使用

参考博客:http://blog.csdn.net/lmj623565791/article/details/46858663

 

 

package com.example.drawable.UI;

import com.example.drawable.util.L;

import android.content.Context;
import android.support.v4.widget.ViewDragHelper;
import android.support.v4.widget.ViewDragHelper.Callback;
import android.util.AttributeSet;
import android.util.Log;
import android.view.MotionEvent;
import android.view.View;
import android.widget.LinearLayout;
/*
 * 使用ViewDragHelper 设置自定义ViewGroup中子View的滑动
 * http://blog.csdn.net/lmj623565791/article/details/46858663
 */
public class ViewDragHelperViewGroup extends LinearLayout {

	private ViewDragHelper mDragger;

	public ViewDragHelperViewGroup(Context context, AttributeSet attrs) {
		super(context, attrs);
		
		/* 第2个参数表示敏感度  */
		mDragger = ViewDragHelper.create(this, 1.0f, new Callback() {
			
			/**
			 * 判断该View是否相应事件(用来设置哪些子View需要相应事件)
			 */
			@Override
			public boolean tryCaptureView(View child, int pointerId) {
				return true;
			}
			
			/**
			 * 对View 水平移动的限制(可以通过设置边界,让View不移动出ViewGroup的范围之外)
			 * 
			 * View child : 表示被点击的view
			 * int left : 表示该view左边相对于ViewGroup左边的距离
			 * int dx : 表示相对于上次移动的变化量
			 */
			@Override
			public int clampViewPositionHorizontal(View child, int left, int dx) {
				L.e("xxx", "left:" + left + "/dx:" + dx);
				
				final int leftBound = getPaddingLeft();
				final int rightBound = getWidth() - child.getWidth() - leftBound;
				
				int newLeft = Math.min(Math.max(leftBound, left), rightBound);
				
				return newLeft;
			}
			
			/**
			 * 对view 竖直移动的限制
			 * 
			 * View child : 表示被点击的view
			 * int left : 表示该view顶部相对于ViewGroup顶部的距离
			 * int dx : 表示相对于上次移动的变化量
			 */
			@Override
			public int clampViewPositionVertical(View child, int top, int dy) {
				L.e("xxx", "top:" + top + "/dy:" + dy);
				return top;
			}

			/**
			 * 改变同一个坐标（x,y）去寻找captureView位置的方法。（具体在：findTopChildUnder方法中） ???
			 */
			@Override
			public int getOrderedChildIndex(int index) {
				L.e("xxx", "getOrderedChildIndex : " + "index:" + index);
				return super.getOrderedChildIndex(index);
			}
			
			/** 
			 * 一下两个方法用来获取横向和纵向移动的范围
			 * 
			 * 当然还有一些方法没有介绍，接下来我们修改下我们的布局文件，我们把我们的TextView全部加上clickable=true，意思就是子View可以消耗事件。
			 * 再次运行，你会发现本来可以拖动的View不动了，（如果有拿Button测试的兄弟应该已经发现这个问题了，我希望你看到这了，而不是已经提问了,哈~）。
			 *
			 * 原因是什么呢？主要是因为，如果子View不消耗事件(也就是不可点击)，那么整个手势（DOWN-MOVE*-UP）都是直接进入onTouchEvent，在onTouchEvent的DOWN的
			 * 时候就确定了captureView。如果消耗事件(可以点击并销毁事件)，那么就会先走onInterceptTouchEvent方法，判断是否可以捕获，而在判断的过程中会去判断另外两个回
			 * 调的方法：getViewHorizontalDragRange和getViewVerticalDragRange，只有这两个方法返回大于0的值才能正常的捕获。
			 *
			 * 所以，如果你用Button测试，或者给TextView添加了clickable = true ，都记得重写下面这两个方法：
			 *
			 */
			@Override
			public int getViewHorizontalDragRange(View child) {
				//return super.getViewHorizontalDragRange(child);
				return getMeasuredWidth()-child.getMeasuredWidth();
			}
			
			@Override
			public int getViewVerticalDragRange(View child) {
				//return super.getViewVerticalDragRange(child);
				return getMeasuredHeight()-child.getMeasuredHeight();
			}

			/** 
			 * 在边界拖动时回调
			 */
			@Override
			public void onEdgeDragStarted(int edgeFlags, int pointerId) {
				//super.onEdgeTouched(edgeFlags, pointerId);
				/*
				 * 在该方法中设置那个view可以被捕获 
				 * mDragger.captureChildView(childView, pointerId);
				 * 
				 * onEdgeDragStarted回调方法中，主动通过captureChildView对其进行捕获，该
				 * 方法可以绕过tryCaptureView，所以我们的tryCaptureView虽然并为返回true，
				 * 但却不影响。注意如果需要使用边界检测需要添加上mDragger.setEdgeTrackingEnabled(ViewDragHelper.EDGE_LEFT);。
				 */
				L.e("xxx", "onEdgeTouched:: " + "edgeFlags:" +edgeFlags + "pointerId:" +pointerId);
			}

			/**
			 * true的时候会锁住当前的边界，false则unLock。
			 */
			@Override
			public boolean onEdgeLock(int edgeFlags) {
				return super.onEdgeLock(edgeFlags);
			}

			/**
			 * 当触摸到边界时回调。
			 */
			@Override
			public void onEdgeTouched(int edgeFlags, int pointerId) {
			}
			
			/**
			 * View 被控制后的回调
			 */
			@Override
			public void onViewCaptured(View capturedChild, int activePointerId) {
				//super.onViewCaptured(capturedChild, activePointerId);
				L.e("xxx", "onViewCaptured::" + "activePointerId:" + activePointerId);
			}

			/**
			 * View 移动的状态发生改变的时候回调
			 */
			@Override
			public void onViewDragStateChanged(int state) {
				//super.onViewDragStateChanged(state);
				//ViewDragHelper.STATE_DRAGGING;
				//ViewDragHelper.STATE_IDLE;
				//ViewDragHelper.STATE_SETTLING;
				Log.e("xxx", "onViewDragStateChanged::" + "state:" + state);
			}

			/**
			 * View 的位置发生改变的时候回调
			 */
			@Override
			public void onViewPositionChanged(View changedView, int left,
					int top, int dx, int dy) {
				//super.onViewPositionChanged(changedView, left, top, dx, dy);
				L.e("xxx", "onViewPositionChanged::" + 
						"left:" + left + "/top:" + top + 
						"/dx:" + dx + "/dy:" + dy );
			}

			/**
			 * 手指释放后的回调(比如可以用来放View 回到初始位置)
			 */
			@Override
			public void onViewReleased(View releasedChild, float xvel,
					float yvel) {
				L.e("xxx", "onViewReleased::" + "xvel:" + xvel + "/yvel:" + yvel );
				/**
				 * 调用该方法可以设置view的位置
				 * mDragger.settleCapturedViewAt(finalLeft, finalTop);
				 * 
				 * 同时需要复写
				 * onViewReleased，我们在onViewReleased中判断如果
				 * 是mAutoBackView则调用settleCapturedViewAt回到初始的位置。大家可以看到紧随
				 * 其后的代码是invalidate();因为其内部使用的是mScroller.startScroll，所以别忘
				 * 了需要invalidate()以及结合computeScroll方法一起。
				 *
				 *  @Override
				 *  public void computeScroll()
				 *  {
				 *      if(mDragger.continueSettling(true))
				 *       {
				 *           invalidate();
				 *       }
				 *  }
				 */
			}
		});
		
		//mDrager 方法总结
		/*
		mDragger.setMinVelocity(minVel);
		
		
		mDragger.setEdgeTrackingEnabled(edgeFlags);
		设置那个边界点击可以被触发 ViewDragHelper.EDGE_LEFT;当需要有onEdgeTouched回调的时候就需要进行该设置
		
	
		mDragger.settleCapturedViewAt(finalLeft, finalTop);
		设置被拖动的view相对于ViewGroup中的位置,调用该方法之后需要调用invalidate()来重绘界面
		 */
		
		
	}
	
	@Override
	public boolean onInterceptTouchEvent(MotionEvent ev) {
		return mDragger.shouldInterceptTouchEvent(ev);//决定我们是否应该拦截当前的事件
	}
	
	@Override
	public boolean onTouchEvent(MotionEvent event) {
		mDragger.processTouchEvent(event);//通过mDragger.processTouchEvent(event)处理事件
		return true;
	}
}