Android - 拖放

---

---

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

• 拖动事件类.

• 拖动侦听器.

• 辅助方法和类.

拖放过程

拖放过程中基本上有四个步骤或状态：

• 开始 - 当您开始在布局中拖动项目时，您的应用程序会调用startDrag()方法来告诉系统开始拖动。startDrag()方法内的参数提供了要拖动的数据、此数据的元数据以及用于绘制拖动阴影的回调。

  系统首先通过回调到您的应用程序以获取拖动阴影来响应。然后它在设备上显示拖动阴影。

  接下来，系统向当前布局中所有 View 对象的注册拖动事件侦听器发送一个操作类型为ACTION_DRAG_STARTED的拖动事件。

  要继续接收拖动事件（包括可能的放下事件），拖动事件侦听器必须返回true，如果拖动事件侦听器返回false，则它将不会接收当前操作的拖动事件，直到系统发送一个操作类型为ACTION_DRAG_ENDED的拖动事件。

• 继续 - 用户继续拖动。系统向拖动点进入的 View 的注册拖动事件侦听器发送 ACTION_DRAG_ENTERED 操作，然后发送 ACTION_DRAG_LOCATION 操作。侦听器可以选择更改其 View 对象的外观以响应事件，或者可以通过突出显示其 View 来做出反应。

  在用户将拖动阴影移出 View 的边界框后，拖动事件侦听器会接收 ACTION_DRAG_EXITED 操作。

• 放下 - 用户在 View 的边界框内释放拖动的项目。系统向 View 对象的侦听器发送一个操作类型为 ACTION_DROP 的拖动事件。

• 结束 - 紧随操作类型 ACTION_DROP 之后，系统会发送一个操作类型为 ACTION_DRAG_ENDED 的拖动事件，以指示拖动操作已结束。

DragEvent 类

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

常量

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

方法

以下是作为 DragEvent 类一部分提供的一些重要且最常用的方法。

侦听拖动事件

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

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

开始拖动事件

您首先要为要移动的数据创建一个ClipData和ClipData.Item。作为ClipData对象的一部分，提供存储在ClipDescription对象中的元数据（位于 ClipData 中）。对于不代表数据移动的拖放操作，您可能希望使用null而不是实际对象。

接下来，您可以扩展View.DragShadowBuilder来为拖动视图创建拖动阴影，或者只需使用View.DragShadowBuilder(View)来创建一个默认的拖动阴影，该阴影与传递给它的 View 参数大小相同，触摸点位于拖动阴影的中心。

示例

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

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

package com.example.saira_000.myapplication;

import android.app.Activity;

import android.content.ClipData;
import android.content.ClipDescription;

import android.support.v7.app.ActionBarActivity;
import android.os.Bundle;
import android.util.Log;

import android.view.DragEvent;
import android.view.Menu;
import android.view.MenuItem;
import android.view.MotionEvent;
import android.view.View;

import android.widget.ImageView;
import android.widget.RelativeLayout;


public class MainActivity extends Activity {
   ImageView img;
   String msg;
   private android.widget.RelativeLayout.LayoutParams layoutParams;
   
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      img=(ImageView)findViewById(R.id.imageView);
      
      img.setOnLongClickListener(new View.OnLongClickListener() {
         @Override
         public boolean onLongClick(View v) {
            ClipData.Item item = new ClipData.Item((CharSequence)v.getTag());
            String[] mimeTypes = {ClipDescription.MIMETYPE_TEXT_PLAIN};
            
            ClipData dragData = new ClipData(v.getTag().toString(),mimeTypes, item);
            View.DragShadowBuilder myShadow = new View.DragShadowBuilder(img);
            
            v.startDrag(dragData,myShadow,null,0);
            return true;
         }
      });
      
      img.setOnDragListener(new View.OnDragListener() {
         @Override
         public boolean onDrag(View v, DragEvent event) {
            switch(event.getAction()) {
               case DragEvent.ACTION_DRAG_STARTED:
               layoutParams = (RelativeLayout.LayoutParams)v.getLayoutParams();
               Log.d(msg, "Action is DragEvent.ACTION_DRAG_STARTED");
               
               // Do nothing
               break;
               
               case DragEvent.ACTION_DRAG_ENTERED:
               Log.d(msg, "Action is DragEvent.ACTION_DRAG_ENTERED");
               int x_cord = (int) event.getX();
               int y_cord = (int) event.getY();
               break;
               
               case DragEvent.ACTION_DRAG_EXITED :
               Log.d(msg, "Action is DragEvent.ACTION_DRAG_EXITED");
               x_cord = (int) event.getX();
               y_cord = (int) event.getY();
               layoutParams.leftMargin = x_cord;
               layoutParams.topMargin = y_cord;
               v.setLayoutParams(layoutParams);
               break;
               
               case DragEvent.ACTION_DRAG_LOCATION  :
               Log.d(msg, "Action is DragEvent.ACTION_DRAG_LOCATION");
               x_cord = (int) event.getX();
               y_cord = (int) event.getY();
               break;
               
               case DragEvent.ACTION_DRAG_ENDED   :
               Log.d(msg, "Action is DragEvent.ACTION_DRAG_ENDED");
               
               // Do nothing
               break;
               
               case DragEvent.ACTION_DROP:
               Log.d(msg, "ACTION_DROP event");
               
               // Do nothing
               break;
               default: break;
            }
            return true;
         }
      });
      
      img.setOnTouchListener(new View.OnTouchListener() {
         @Override
         public boolean onTouch(View v, MotionEvent event) {
            if (event.getAction() == MotionEvent.ACTION_DOWN) {
               ClipData data = ClipData.newPlainText("", "");
               View.DragShadowBuilder shadowBuilder = new View.DragShadowBuilder(img);
               
               img.startDrag(data, shadowBuilder, img, 0);
               img.setVisibility(View.INVISIBLE);
               return true;
            } else {
               return false;
            }
         }
      });
   }
}

res/layout/activity_main.xml文件的内容如下：

在以下代码中，abc 表示 tutorialspoint.com 的徽标。

<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:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   android:paddingBottom="@dimen/activity_vertical_margin" 
   tools:context=".MainActivity">
   
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Drag and Drop Example"
      android:id="@+id/textView"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true"
      android:textSize="30dp" />
      
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Tutorials Point"
      android:id="@+id/textView2"
      android:layout_below="@+id/textView"
      android:layout_centerHorizontal="true"
      android:textSize="30dp"
      android:textColor="#ff14be3c" />>
      
   <ImageView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/imageView"
      android:src="@drawable/abc"
      android:layout_below="@+id/textView2"
      android:layout_alignRight="@+id/textView2"
      android:layout_alignEnd="@+id/textView2"
      android:layout_alignLeft="@+id/textView2"
      android:layout_alignStart="@+id/textView2" />

</RelativeLayout>

res/values/strings.xml的内容将如下所示，以定义两个新常量：

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <string name="app_name">My Application</string>
</resources>

AndroidManifest.xml的默认内容如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.saira_000.myapplication" >
      
   <application
      android:allowBackup="true"
      android:icon="@drawable/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >
      
      <activity
         android:name=".MainActivity"
         android:label="@string/app_name" >
      
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
      
      </activity>
      
   </application>
</manifest>

让我们尝试运行您的My Application应用程序。我假设您在进行环境设置时已创建了您的AVD。要从Android Studio运行应用程序，请打开项目中的一个Activity文件，然后点击工具栏中的运行图标。Android Studio会将应用程序安装到您的AVD上并启动它，如果您的设置和应用程序一切正常，它将显示以下模拟器窗口：

现在，长按显示的TutorialsPoint徽标，您会看到徽标图像在长按1秒后稍微移动，这时您应该开始拖动图像。您可以将其拖动到屏幕周围，并将其放置在新位置。