Android学习系列(10)--App列表之拖拽ListView(上)

 研究了很久的拖拽ListView的实现,受益良多,特此与尔共飨。
      鉴于这部分内容网上的资料少而简陋,而具体的实现过程或许对大家才有帮助,为了详尽而不失真,我们一步一步分析,分成两篇文章。
一、准备。
1.需求问题
      初步:实现列表的拖拽效果(可参考Android源码下packages/apps/Music中的播放列表TouchInterceptor.java源码)。
               (提前说明一下,本文不是完全按照Music中实现的,代码实现方式做了一些调整,去掉来很多无关的东西,方便大家理解,效果上也修改成了另外一种 个人认为是更简单更高效的一套。)
      拓展:借鉴上一篇文章Android学习系列(9)--App列表之分组ListView,实现分组列表的拖拽效果。
      下面以初步实现为例子,逐步展开实现步骤。
2.搭建主界面DragListActivity.java和主布局drag_list_activity.xml。
  1. public class DragListActivity extends Activity {
  2. //数据列表
  3. private List<String> list = null;
  4. //数据适配器
  5. private DragListAdapter adapter = null;
  6. //存放分组标签
  7. public static List<String> groupKey= new ArrayList<String>();
  8. //分组一
  9. private List<String> navList = new ArrayList<String>();
  10. //分组二
  11. private List<String> moreList = new ArrayList<String>();
  12. @Override
  13. public void onCreate(Bundle savedInstanceState) {
  14. super.onCreate(savedInstanceState);
  15. setContentView(R.layout.drag_list_activity);
  16. //初始化样本数据
  17. initData();
  18. //后面会介绍DragListView
  19. DragListView dragListView = (DragListView)findViewById(R.id.drag_list);
  20. adapter = new DragListAdapter(this, list);
  21. dragListView.setAdapter(adapter);
  22. }
  23. }

复制代码

3.列表项的布局drag_list_item.xml。 

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <!-- 强调一点,使用相对布局 -->
  3. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
  4. android:layout_width="fill_parent"
  5. android:layout_height="wrap_content">
  6. <TextView
  7. android:id="@+id/drag_list_item_text"
  8. android:layout_width="wrap_content"
  9. android:layout_height="@dimen/drag_item_normal_height"
  10. android:paddingLeft="5dip"
  11. android:layout_alignParentLeft="true"
  12. android:layout_centerVertical="true"
  13. android:gravity="center_vertical"/>
  14. <ImageView android:id="@+id/drag_list_item_image"
  15. android:src="@drawable/list_icon"
  16. android:layout_alignParentRight="true"
  17. android:layout_centerVertical="true"
  18. android:layout_width="wrap_content"
  19. android:layout_height="@dimen/drag_item_normal_height"/>
  20. </RelativeLayout>

复制代码

4.准备样本数据。
      我已经准备好了两组数据,在前面提到的initData()方法中执行初始化。

  1. public void initData(){
  2. //数据结果
  3. list = new ArrayList<String>();
  4. //groupKey存放的是分组标签
  5. groupKey.add("A组");
  6. groupKey.add("B组");
  7. for(int i=0; i<5; i++){
  8. navList.add("A选项"+i);
  9. }
  10. list.add("A组");
  11. list.addAll(navList);
  12. for(int i=0; i<8; i++){
  13. moreList.add("B选项"+i);
  14. }
  15. list.add("B组");
  16. list.addAll(moreList);
  17. }

复制代码

这里定义了分组标签集合groupKey后面分组的时候会用到。
5.自定义适配器类DragListAdapter。
      接着我们搭建数据适配器,负责把list的数据填充到ListView中。
  1. public static class DragListAdapter extends ArrayAdapter<String>{
  2. public DragListAdapter(Context context, List<String> objects) {
  3. super(context, 0, objects);
  4. }
  5. @Override
  6. public View getView(int position, View convertView, ViewGroup parent) {
  7. View view = convertView;
  8. if(view==null){
  9. //加载列表项模板
  10. view = LayoutInflater.from(getContext()).inflate(R.layout.drag_list_item, null);
  11. }
  12. TextView textView = (TextView)view.findViewById(R.id.drag_list_item_text);
  13. textView.setText(getItem(position));
  14. return view;
  15. }
  16. }

复制代码

注意getItem(position)会取得数组适配器中position位置的T(这里是字符串),比较好用的一个方法。
       至此,我们准备了一个正常的数据列表,效果如下:
<ignore_js_op>Android学习系列(10)--App列表之拖拽ListView(上)
二、实现
      上面部分是我们的一个 准备工作,接下来我们通过自定义ListView,重写ListView中onInterceptTouchEvent(),onTouchEvent()方法来响应触控事件做相应的界面调整(选中,拖动,数据更改后刷新界面)等等。
6.自定义视图类。
  1. //自定义ListView,准备改造成自己想要的ListView
  2. //这样的好处是我们不仅可以直接使用ListView很多现成的稳定的方法,而且可以重写方法改写ListView的行为(利用的是java面向对象的继承特性,本人喜欢在任何代码中分析面向对象的特性、原则和模式)
  3. public class DragListView extends ListView {
  4. private int scaledTouchSlop;//判断滑动的一个距离,scroll的时候会用到
  5. public DragListView(Context context, AttributeSet attrs) {
  6. super(context, attrs);
  7. scaledTouchSlop = ViewConfiguration.get(context).getScaledTouchSlop();
  8. }
  9. }

复制代码

7.重写触控拦截事件方法onInterceptTouchEvent()。
       为了能在子控件响应触摸事件的情况下此ListView也能监听到触摸事件,我们把重写这个方法,做一些初始化工作。我们在这里捕获down事件,在down事件中,我们做一些拖动的准备工作:
      1)获取点击数据项,初始化一些变量;
      2)判断是否是拖动还是仅仅点击;
      3)如果是拖动,建立拖动影像;
       这些工作是我们后面拖动的一个执行基础,非常重要。

  1. //下面定义要使用的所有变量
  2. private ImageView dragImageView;//被拖拽项的影像,其实就是一个ImageView
  3. private int dragSrcPosition;//手指拖动项原始在列表中的位置
  4. private int dragPosition;//手指拖动的时候,当前拖动项在列表中的位置
  5. private int dragPoint;//在当前数据项中的位置
  6. private int dragOffset;//当前视图和屏幕的距离(这里只使用了y方向上)
  7. private WindowManager windowManager;//windows窗口控制类
  8. private WindowManager.LayoutParams windowParams;//用于控制拖拽项的显示的参数
  9. private int scaledTouchSlop;//判断滑动的一个距离
  10. private int upScrollBounce;//拖动的时候,开始向上滚动的边界
  11. private int downScrollBounce;//拖动的时候,开始向下滚动的边界
  12. @Override
  13. public boolean onInterceptTouchEvent(MotionEvent ev) {
  14. //捕获down事件
  15. if(ev.getAction()==MotionEvent.ACTION_DOWN){
  16. int x = (int)ev.getX();
  17. int y = (int)ev.getY();
  18. //选中的数据项位置,使用ListView自带的pointToPosition(x, y)方法
  19. dragSrcPosition = dragPosition = pointToPosition(x, y);
  20. //如果是无效位置(超出边界,分割线等位置),返回
  21. if(dragPosition==AdapterView.INVALID_POSITION){
  22. return super.onInterceptTouchEvent(ev);
  23. }
  24. //获取选中项View
  25. //getChildAt(int position)显示display在界面的position位置的View
  26. //getFirstVisiblePosition()返回第一个display在界面的view在adapter的位置position,可能是0,也可能是4
  27. ViewGroup itemView = (ViewGroup) getChildAt(dragPosition-getFirstVisiblePosition());
  28. //dragPoint点击位置在点击View内的相对位置
  29. //dragOffset屏幕位置和当前ListView位置的偏移量,这里只用到y坐标上的值
  30. //这两个参数用于后面拖动的开始位置和移动位置的计算
  31. dragPoint = y - itemView.getTop();
  32. dragOffset = (int) (ev.getRawY() - y);
  33. //获取右边的拖动图标,这个对后面分组拖拽有妙用
  34. View dragger = itemView.findViewById(R.id.drag_list_item_image);
  35. //如果在右边位置(拖拽图片左边的20px的右边区域)
  36. if(dragger!=null&&x>dragger.getLeft()-20){
  37. //准备拖动
  38. //初始化拖动时滚动变量
  39. //scaledTouchSlop定义了拖动的偏差位(一般+-10)
  40. //upScrollBounce当在屏幕的上部(上面1/3区域)或者更上的区域,执行拖动的边界,downScrollBounce同理定义
  41. upScrollBounce = Math.min(y-scaledTouchSlop, getHeight()/3);
  42. downScrollBounce = Math.max(y+scaledTouchSlop, getHeight()*2/3);
  43. //设置Drawingcache为true,获得选中项的影像bm,就是后面我们拖动的哪个头像
  44. itemView.setDrawingCacheEnabled(true);
  45. Bitmap bm = Bitmap.createBitmap(itemView.getDrawingCache());
  46. //准备拖动影像(把影像加入到当前窗口,并没有拖动,拖动操作我们放在onTouchEvent()的move中执行)
  47. startDrag(bm, y);
  48. }
  49. return false;
  50. }
  51. return super.onInterceptTouchEvent(ev);
  52. }

复制代码

看到上面的一大堆变量和操作,你可能有些眼花缭乱,在后面使用的时候回头再去理解也可。
      开始拖动影像startDrag()方法:

  1. /**
  2. * 准备拖动,初始化拖动项的图像
  3. * @param bm
  4. * @param y
  5. */
  6. public void startDrag(Bitmap bm ,int y){
  7. //释放影像,在准备影像的时候,防止影像没释放,每次都执行一下
  8. stopDrag();
  9. windowParams = new WindowManager.LayoutParams();
  10. //从上到下计算y方向上的相对位置,
  11. windowParams.gravity = Gravity.TOP;
  12. windowParams.x = 0;
  13. windowParams.y = y - dragPoint + dragOffset;
  14. windowParams.width = WindowManager.LayoutParams.WRAP_CONTENT;
  15. windowParams.height = WindowManager.LayoutParams.WRAP_CONTENT;
  16. //下面这些参数能够帮助准确定位到选中项点击位置,照抄即可
  17. windowParams.flags = WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE
  18. | WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE
  19. | WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
  20. | WindowManager.LayoutParams.FLAG_LAYOUT_IN_SCREEN;
  21. windowParams.format = PixelFormat.TRANSLUCENT;
  22. windowParams.windowAnimations = 0;
  23. //把影像ImagView添加到当前视图中
  24. ImageView imageView = new ImageView(getContext());
  25. imageView.setImageBitmap(bm);
  26. windowManager = (WindowManager)getContext().getSystemService("window");
  27. windowManager.addView(imageView, windowParams);
  28. //把影像ImageView引用到变量drawImageView,用于后续操作(拖动,释放等等)
  29. dragImageView = imageView;
  30. }

复制代码

stopDrag()方法如下:

  1. /**
  2. * 停止拖动,去除拖动项的头像
  3. */
  4. public void stopDrag(){
  5. if(dragImageView!=null){
  6. windowManager.removeView(dragImageView);
  7. dragImageView = null;
  8. }
  9. }

复制代码

运行看看,我们点击一项的时候没有什么反应,但是细心观察的话,其实点击项上有一层淡淡的重影,这就是我们定义的点击项的影像,后面要做的就是拖动这个影像,放下影像以及放下位置的数据项插入和原数据项位置的删除,这部分内容以及后续扩展的内容我们放到下篇中继续分析并实现。
        未完待续...

上一篇:Android学习系列(12)--App列表之拖拽GridView


下一篇:gitlab 迁移、升级打怪之路:8.8.5--> 8.10.8 --> 8.17.8 --> 9.5.9 --> 10.1.4 --> 10.2.5