Android學習系列(10)–App列表之拖拽ListView(上)

      研究了很久的拖拽ListView的實現，受益良多，特此與爾共饗。
      鑒於這部分內容網上的資料少而簡陋，而具體的實現過程或許對大家才有協助，為了詳盡而不失真，我們一步一步分析，分成兩篇文章。 

一、準備。

1.需求問題
      初步：實現列表的拖拽效果(可參考Android源碼下packages/apps/Music中的播放清單TouchInterceptor.java源碼)。
               (提前說明一下，本文不是完全按照Music中實現的，代碼實現方式做了一些調整，去掉來很多無關的東西，方便大家理解，效果上也修改成了另外一種

個人認為是更簡單更高效的一套。)
      拓展：借鑒上一篇文章Android學習系列(9)--App列表之分組ListView，實現分組列表的拖拽效果。
      下面以初步實現為例子，逐步展開實現步驟。

2.搭建主介面DragListActivity.java和主布局drag_list_activity.xml。

public class DragListActivity extends Activity {        //資料列表    private List<String> list = null;        //資料配接器    private DragListAdapter adapter = null;        //存放分組標籤    public static List<String> groupKey= new ArrayList<String>();    //分組一    private List<String> navList = new ArrayList<String>();    //分組二    private List<String> moreList = new ArrayList<String>();        @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.drag_list_activity);                //初始化樣本資料        initData();                //後面會介紹DragListView        DragListView dragListView = (DragListView)findViewById(R.id.drag_list);        adapter = new DragListAdapter(this, list);        dragListView.setAdapter(adapter);    }}

3.清單項目的布局drag_list_item.xml。 

<?xml version="1.0" encoding="utf-8"?><!-- 強調一點，使用相對布局 --><RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="fill_parent"    android:layout_height="wrap_content">    <TextView       android:id="@+id/drag_list_item_text"        android:layout_width="wrap_content"        android:layout_height="@dimen/drag_item_normal_height"       android:paddingLeft="5dip"       android:layout_alignParentLeft="true"       android:layout_centerVertical="true"       android:gravity="center_vertical"/>    <ImageView android:id="@+id/drag_list_item_image"       android:src="@drawable/list_icon"       android:layout_alignParentRight="true"       android:layout_centerVertical="true"       android:layout_width="wrap_content"       android:layout_height="@dimen/drag_item_normal_height"/></RelativeLayout>

4.準備樣本資料。
      我已經準備好了兩組資料，在前面提到的initData()方法中執行初始化。

    public void initData(){        //資料結果        list = new ArrayList<String>();                //groupKey存放的是分組標籤        groupKey.add("A組");        groupKey.add("B組");                for(int i=0; i<5; i++){            navList.add("A選項"+i);        }        list.add("A組");        list.addAll(navList);                for(int i=0; i<8; i++){            moreList.add("B選項"+i);        }        list.add("B組");        list.addAll(moreList);    }

      這裡定義了分組標籤集合groupKey後面分組的時候會用到。

5.自訂配接器類DragListAdapter。
      接著我們搭建資料配接器，負責把list的資料填充到ListView中。

    public static class DragListAdapter extends ArrayAdapter<String>{        public DragListAdapter(Context context, List<String> objects) {            super(context, 0, objects);        }        @Override        public View getView(int position, View convertView, ViewGroup parent) {            View view = convertView;            if(view==null){                //載入清單項目模板                view = LayoutInflater.from(getContext()).inflate(R.layout.drag_list_item, null);            }                        TextView textView = (TextView)view.findViewById(R.id.drag_list_item_text);            textView.setText(getItem(position));            return view;        }    }

       注意getItem(position)會取得數組適配器中position位置的T（這裡是字串），比較好用的一個方法。

       至此，我們準備了一個正常的資料列表，效果如下：
 

二、實現

      上面部分是我們的一個 準備工作，接下來我們通過自訂ListView，重寫ListView中onInterceptTouchEvent(),onTouchEvent()方法來響應觸控事件做相應的介面調整(選中，拖動，資料更改後重新整理介面)等等。

6.自訂視圖類。

//自訂ListView，準備改造成自己想要的ListView//這樣的好處是我們不僅可以直接使用ListView很多現成的穩定的方法，而且可以重寫方法改寫ListView的行為（利用的是java物件導向的繼承特性，本人喜歡在任何代碼中分析物件導向的特性、原則和模式）public class DragListView extends ListView {    private int scaledTouchSlop;//判斷滑動的一個距離,scroll的時候會用到    public DragListView(Context context, AttributeSet attrs) {        super(context, attrs);        scaledTouchSlop = ViewConfiguration.get(context).getScaledTouchSlop();    }}

7.重寫觸控攔截事件方法onInterceptTouchEvent()。
       為了能在子控制項響應觸摸事件的情況下此ListView也能監聽到觸摸事件，我們把重寫這個方法，做一些初始化工作。我們在這裡捕獲down事件，在down事件中，我們做一些拖動的準備工作：
      1）擷取點擊資料項目，初始化一些變數；
      2）判斷是否是拖動還是僅僅點擊；
      3）如果是拖動，建立拖動影像；
       這些工作是我們後面拖動的一個執行基礎，非常重要。 

    //下面定義要使用的所有變數    private ImageView dragImageView;//被拖拽項的影像，其實就是一個ImageView    private int dragSrcPosition;//手指拖動項原始在列表中的位置    private int dragPosition;//手指拖動的時候，當前拖動項在列表中的位置        private int dragPoint;//在當前資料項目中的位置    private int dragOffset;//當前視圖和螢幕的距離(這裡只使用了y方向上)        private WindowManager windowManager;//windows視窗控制類    private WindowManager.LayoutParams windowParams;//用於控制拖拽項的顯示的參數        private int scaledTouchSlop;//判斷滑動的一個距離    private int upScrollBounce;//拖動的時候，開始向上滾動的邊界    private int downScrollBounce;//拖動的時候，開始向下滾動的邊界    @Override    public boolean onInterceptTouchEvent(MotionEvent ev) {            //捕獲down事件            if(ev.getAction()==MotionEvent.ACTION_DOWN){            int x = (int)ev.getX();            int y = (int)ev.getY();                        //選中的資料項目位置，使用ListView內建的pointToPosition(x, y)方法            dragSrcPosition = dragPosition = pointToPosition(x, y);            //如果是無效位置(超出邊界，分割線等位置)，返回            if(dragPosition==AdapterView.INVALID_POSITION){                return super.onInterceptTouchEvent(ev);            }            //擷取選中項View            //getChildAt(int position)顯示display在介面的position位置的View            //getFirstVisiblePosition()返回第一個display在介面的view在adapter的位置position，可能是0，也可能是4            ViewGroup itemView = (ViewGroup) getChildAt(dragPosition-getFirstVisiblePosition());                        //dragPoint點擊位置在點擊View內的相對位置            //dragOffset螢幕位置和當前ListView位置的位移量，這裡只用到y座標上的值            //這兩個參數用於後面拖動的開始位置和移動位置的計算            dragPoint = y - itemView.getTop();            dragOffset = (int) (ev.getRawY() - y);                        //擷取右邊的拖動表徵圖，這個對後面分組拖拽有妙用            View dragger = itemView.findViewById(R.id.drag_list_item_image);            //如果在右邊位置（拖拽圖片左邊的20px的右邊地區）            if(dragger!=null&&x>dragger.getLeft()-20){                //準備拖動                //初始化拖動時滾動變數                //scaledTouchSlop定義了拖動的偏差位(一般+-10)                //upScrollBounce當在螢幕的上部(上面1/3地區)或者更上的地區，執行拖動的邊界，downScrollBounce同理定義                upScrollBounce = Math.min(y-scaledTouchSlop, getHeight()/3);                downScrollBounce = Math.max(y+scaledTouchSlop, getHeight()*2/3);                                //設定Drawingcache為true，獲得選中項的影像bm，就是後面我們拖動的哪個頭像                itemView.setDrawingCacheEnabled(true);                Bitmap bm = Bitmap.createBitmap(itemView.getDrawingCache());                                //準備拖動影像(把影像加入到當前視窗，並沒有拖動，拖動操作我們放在onTouchEvent()的move中執行)                startDrag(bm, y);            }            return false;         }         return super.onInterceptTouchEvent(ev);    }

      看到上面的一大堆變數和操作，你可能有些眼花繚亂，在後面使用的時候回頭再去理解也可。
      開始拖動影像startDrag()方法：

    /**     * 準備拖動，初始化拖動項的映像     * @param bm     * @param y     */    public void startDrag(Bitmap bm ,int y){       //釋放影像，在準備影像的時候，防止影像沒釋放，每次都執行一下        stopDrag();                windowParams = new WindowManager.LayoutParams();        //從上到下計算y方向上的相對位置，        windowParams.gravity = Gravity.TOP;        windowParams.x = 0;        windowParams.y = y - dragPoint + dragOffset;        windowParams.width = WindowManager.LayoutParams.WRAP_CONTENT;        windowParams.height = WindowManager.LayoutParams.WRAP_CONTENT;        //下面這些參數能夠協助準確定位到選中項點擊位置，照抄即可        windowParams.flags = WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE                            | WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE                            | WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON                            | WindowManager.LayoutParams.FLAG_LAYOUT_IN_SCREEN;        windowParams.format = PixelFormat.TRANSLUCENT;        windowParams.windowAnimations = 0;        //把影像ImagView添加到當前視圖中        ImageView imageView = new ImageView(getContext());        imageView.setImageBitmap(bm);        windowManager = (WindowManager)getContext().getSystemService("window");        windowManager.addView(imageView, windowParams);        //把影像ImageView引用到變數drawImageView，用於後續操作(拖動，釋放等等)        dragImageView = imageView;    }

       stopDrag()方法如下：

    /**     * 停止拖動，去除拖動項的頭像     */    public void stopDrag(){        if(dragImageView!=null){            windowManager.removeView(dragImageView);            dragImageView = null;        }    }

        運行看看，我們點擊一項的時候沒有什麼反應，但是細心觀察的話，其實點擊項上有一層淡淡的重影，這就是我們定義的點擊項的影像，後面要做的就是拖動這個影像，放下影像以及放下位置的資料項目插入和原資料項目位置的刪除，這部分內容以及後續擴充的內容我們放到下篇中繼續分析並實現。
        未完待續...