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>