Android(安卓)拖放

Android 拖放框架支持用户使用图形拖放手势将数据从当前布局中的一个视图移动到另一个视图。从 API 11 开始,支持将视图拖放到其他视图或视图组。该框架包括以下三个重要组件,以支持拖放功能:

  • Drag 事件类
  • Drag 监听器
  • Helper 方法和类

Drag/Drop(拖放)过程

拖放过程基本上有 4 个步骤或状态:

  • Started(开始) − 当您开始拖动布局中的项目时,会发生此事件,应用程序调用 startDrag() 方法通知系统开始拖动。startDrag() 方法中的参数提供要拖动的数据、该数据的元数据以及用于绘制拖动阴影的回调。系统首先通过调用您的应用程序来获得拖动阴影来进行响应。然后在设备上显示拖动阴影。接下来,系统将动作类型为 ACTION_DRAG_STARTED 的拖动事件发送给当前布局中所有 View 对象的注册拖动事件监听器。要继续接收拖动事件,包括可能的拖放事件,拖动事件监听器必须返回 true。如果拖动事件侦听程序返回 false,则在系统发送动作类型为 ACTION_DRAG_ENDED 的拖动事件之前,它将不会接收当前操作的拖动事件。

  • Continuing(继续) − 用户继续拖动。系统将 ACTION_DRAG_ENTERED 动作后跟 ACTION_DRAG_LOCATION 动作发送给拖动点进入的视图的注册拖动事件监听器。侦听器可以选择更改其 View 对象的外观以响应事件,也可以通过突出显示其 View 来做出反应。在用户将拖动阴影移动到视图的边界框之外之后,拖动事件监听器接收 ACTION_DRAG_EXITED 动作。

  • Dropped(放) − 用户在视图的边界框内释放拖动的项目。系统向 View 对象的监听器发送动作类型为 ACTION_DROP 的拖动事件。

  • Ended(结束) − 就在动作类型 ACTION_DROP 之后,系统发送一个动作类型为 ACTION_DRAG_ENDED 的拖拽事件,以指示拖拽操作结束。


DragEvent 类

DragEvent 表示在拖放操作期间系统在不同时间发出的事件。这个类提供了一些常量和我们在拖放过程中使用的重要方法。

常量

以下是作为 DragEvent 类的一部分可用的所有常量整数。

编号常量 & 描述
1

ACTION_DRAG_STARTED

表示开始拖放操作。

2

ACTION_DRAG_ENTERED

向视图发出拖动点已进入视图边界框的信号。

3

ACTION_DRAG_LOCATION

如果拖动阴影仍在视图对象的边界框内,则在 ACTION_DRAG_ENTERED 之后发送到视图。

4

ACTION_DRAG_EXITED

表示用户已将拖动阴影移动到视图的边界框之外。

5

ACTION_DROP

向视图发出信号,表示用户已释放拖动阴影,并且拖动点在视图的边界框内。

6

ACTION_DRAG_ENDED

向视图发出拖放操作已结束的信号。

方法

以下是作为 DragEvent 类的一部分可用的几个重要且最常用的方法。

编号常量 & 描述
1

int getAction()

检查此事件的 Action 值。

2

ClipData getClipData()

返回作为 startDrag() 调用的一部分发送到系统的 ClipData 对象。

3

ClipDescription getClipDescription()

返回 ClipData 中包含的 ClipDescription 对象。

4

boolean getResult()

返回拖放操作结果的指示。

5

floatgetX()

获取拖动点的 X 坐标。

6

float getY()

获取拖动点的 Y 坐标。

7

String toString()

返回此 DragEvent 对象的字符串表示形式。


监听拖动事件

如果您希望布局中的任何视图都应响应 Drag 事件,那么您的视图要么实现 View.OnDragListener 或设置 onDragEvent(DragEvent) 回调方法。当系统调用方法或监听器时,它会向它们传递一个上面解释过的 DragEvent 对象。您可以同时拥有 View 对象的监听器和回调方法。如果发生这种情况,系统首先调用监听器,然后定义回调,只要监听器返回 true

onDragEvent(DragEvent) 方法和 View.OnDragListener 的组合类似于 onTouchEvent()View 的组合。OnTouchListener 用于旧版本 Android 中的触摸事件。


启动拖动事件

首先为要移动的数据创建 ClipDataClipDataItem。作为 ClipData 对象的一部分,提供存储在 ClipData 中的 ClipDescription 对象中的元数据。对于不表示数据移动的拖放操作,您可能希望使用 null 而不是实际对象。

接下来,您可以扩展 View.DragShadowBuilder 以创建用于拖动视图的拖动阴影,也可以简单地使用 View.DragShadowBuilder(View) 创建与传递给它的 view 参数大小相同的默认拖动阴影,触摸点位于拖动阴影的中心。


实例

以下实例显示了使用了 View.setOnLongClickListener(), View.setOnTouchListener()View.OnDragEventListener() 进行简单拖放的功能。

步骤描述
1您将使用 Android studio IDE 创建一个 Android 应用程序,并将其命名为 com.example.saira_000.myapplication 包下的 My Application
2修改 src/MainActivity.java 文件,并添加代码来定义事件监听器以及示例中使用的 logo 图像的回调方法。
3复制图像 abc.pngres/drawable-* 文件夹中您可以使用不同分辨率的图像,以防您想为不同设备提供图像。
4修改布局 XML 文件 res/layout/activity_main.XML 以定义 logo 图像的默认视图。
5运行应用程序以启动 Android 模拟器并验证应用程序中所做更改的结果。

以下是修改后的主活动文件 src/MainActivity.java 的内容。该文件可以包括每个基本生命周期方法。

  1. package com.example.saira_000.myapplication;
  2. import android.app.Activity;
  3. import android.content.ClipData;
  4. import android.content.ClipDescription;
  5. import android.support.v7.app.ActionBarActivity;
  6. import android.os.Bundle;
  7. import android.util.Log;
  8. import android.view.DragEvent;
  9. import android.view.Menu;
  10. import android.view.MenuItem;
  11. import android.view.MotionEvent;
  12. import android.view.View;
  13. import android.widget.ImageView;
  14. import android.widget.RelativeLayout;
  15. public class MainActivity extends Activity {
  16. ImageView img;
  17. String msg;
  18. private android.widget.RelativeLayout.LayoutParams layoutParams;
  19. @Override
  20. protected void onCreate(Bundle savedInstanceState) {
  21. super.onCreate(savedInstanceState);
  22. setContentView(R.layout.activity_main);
  23. img=(ImageView)findViewById(R.id.imageView);
  24. img.setOnLongClickListener(new View.OnLongClickListener() {
  25. @Override
  26. public boolean onLongClick(View v) {
  27. ClipData.Item item = new ClipData.Item((CharSequence)v.getTag());
  28. String[] mimeTypes = {ClipDescription.MIMETYPE_TEXT_PLAIN};
  29. ClipData dragData = new ClipData(v.getTag().toString(),mimeTypes, item);
  30. View.DragShadowBuilder myShadow = new View.DragShadowBuilder(img);
  31. v.startDrag(dragData,myShadow,null,0);
  32. return true;
  33. }
  34. });
  35. img.setOnDragListener(new View.OnDragListener() {
  36. @Override
  37. public boolean onDrag(View v, DragEvent event) {
  38. switch(event.getAction()) {
  39. case DragEvent.ACTION_DRAG_STARTED:
  40. layoutParams = (RelativeLayout.LayoutParams)v.getLayoutParams();
  41. Log.d(msg, "Action is DragEvent.ACTION_DRAG_STARTED");
  42. // Do nothing
  43. break;
  44. case DragEvent.ACTION_DRAG_ENTERED:
  45. Log.d(msg, "Action is DragEvent.ACTION_DRAG_ENTERED");
  46. int x_cord = (int) event.getX();
  47. int y_cord = (int) event.getY();
  48. break;
  49. case DragEvent.ACTION_DRAG_EXITED :
  50. Log.d(msg, "Action is DragEvent.ACTION_DRAG_EXITED");
  51. x_cord = (int) event.getX();
  52. y_cord = (int) event.getY();
  53. layoutParams.leftMargin = x_cord;
  54. layoutParams.topMargin = y_cord;
  55. v.setLayoutParams(layoutParams);
  56. break;
  57. case DragEvent.ACTION_DRAG_LOCATION :
  58. Log.d(msg, "Action is DragEvent.ACTION_DRAG_LOCATION");
  59. x_cord = (int) event.getX();
  60. y_cord = (int) event.getY();
  61. break;
  62. case DragEvent.ACTION_DRAG_ENDED :
  63. Log.d(msg, "Action is DragEvent.ACTION_DRAG_ENDED");
  64. // Do nothing
  65. break;
  66. case DragEvent.ACTION_DROP:
  67. Log.d(msg, "ACTION_DROP event");
  68. // Do nothing
  69. break;
  70. default: break;
  71. }
  72. return true;
  73. }
  74. });
  75. img.setOnTouchListener(new View.OnTouchListener() {
  76. @Override
  77. public boolean onTouch(View v, MotionEvent event) {
  78. if (event.getAction() == MotionEvent.ACTION_DOWN) {
  79. ClipData data = ClipData.newPlainText("", "");
  80. View.DragShadowBuilder shadowBuilder = new View.DragShadowBuilder(img);
  81. img.startDrag(data, shadowBuilder, img, 0);
  82. img.setVisibility(View.INVISIBLE);
  83. return true;
  84. } else {
  85. return false;
  86. }
  87. }
  88. });
  89. }
  90. }

以下是 res/layout/activity_main.xml 文件的内容−在下面的代码中,

abc 表示 logo

  1. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
  2. xmlns:tools="http://schemas.android.com/tools"
  3. android:layout_width="match_parent"
  4. android:layout_height="match_parent"
  5. android:paddingLeft="@dimen/activity_horizontal_margin"
  6. android:paddingRight="@dimen/activity_horizontal_margin"
  7. android:paddingTop="@dimen/activity_vertical_margin"
  8. android:paddingBottom="@dimen/activity_vertical_margin"
  9. tools:context=".MainActivity">
  10. <TextView
  11. android:layout_width="wrap_content"
  12. android:layout_height="wrap_content"
  13. android:text="Drag and Drop Example"
  14. android:id="@+id/textView"
  15. android:layout_alignParentTop="true"
  16. android:layout_centerHorizontal="true"
  17. android:textSize="30dp" />
  18. <TextView
  19. android:layout_width="wrap_content"
  20. android:layout_height="wrap_content"
  21. android:text="demo"
  22. android:id="@+id/textView2"
  23. android:layout_below="@+id/textView"
  24. android:layout_centerHorizontal="true"
  25. android:textSize="30dp"
  26. android:textColor="#ff14be3c" />>
  27. <ImageView
  28. android:layout_width="wrap_content"
  29. android:layout_height="wrap_content"
  30. android:id="@+id/imageView"
  31. android:src="@drawable/abc"
  32. android:layout_below="@+id/textView2"
  33. android:layout_alignRight="@+id/textView2"
  34. android:layout_alignEnd="@+id/textView2"
  35. android:layout_alignLeft="@+id/textView2"
  36. android:layout_alignStart="@+id/textView2" />
  37. </RelativeLayout>

下面是 res/values/strings.xml 的内容,定义常量:

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <resources>
  3. <string name="app_name">My Application</string>
  4. </resources>

下面是 AndroidManifest.xml 的默认内容:

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"
  3. package="com.example.saira_000.myapplication" >
  4. <application
  5. android:allowBackup="true"
  6. android:icon="@drawable/ic_launcher"
  7. android:label="@string/app_name"
  8. android:theme="@style/AppTheme" >
  9. <activity
  10. android:name=".MainActivity"
  11. android:label="@string/app_name" >
  12. <intent-filter>
  13. <action android:name="android.intent.action.MAIN" />
  14. <category android:name="android.intent.category.LAUNCHER" />
  15. </intent-filter>
  16. </activity>
  17. </application>
  18. </manifest>

让我们尝试运行 My Application 应用程序。我假设您在进行环境设置时创建了 AVD。要从 Android Studio 运行应用程序,请打开项目的 activity 文件之一,然后单击工具栏上的运行 Eclipse Eclipse Run Icon 图标。Android studio 在您的 AVD 上安装应用程序并启动它,如果您的设置和应用程序一切正常,它将显示以下模拟器窗口:

现在,长时间单击显示的图标,您将看到徽标图像在长时间单击1秒后从其位置稍微移动,此时您应该开始拖动图像。您可以在屏幕上拖动它并将其放置在新位置。