Android - Drag and Drop功能

封面图 • 2025-11-20 • Android开发

在 Android 中，**Drag and Drop（拖放）功能**是一种让用户通过触摸屏拖动和放置视图元素的交互方式。从 Android 12（API 级别 31）开始，系统引入了新的 **`DragAndDrop` API**，简化了拖放操作的实现。在此之前，开发者通常使用 `ViewGroup` 的 `onInterceptTouchEvent()` 和 `onTouchEvent()` 来手动处理拖放逻辑。

---

## ✅ Android 拖放功能的核心组件

### 1. **`DragEvent`**
- 表示一个拖放事件。
- 包含事件类型（如 `ACTION_DRAG_STARTED`, `ACTION_DROP` 等）、拖动的数据等信息。

### 2. **`DragListener`**
- 用于监听拖放事件。
- 实现 `OnDragListener` 接口，重写 `onDrag(View v, DragEvent event)` 方法。

### 3. **`startDragAndDrop()`**
- 启动拖放操作。
- 可以传递 `ClipData` 数据，并指定拖动时的图标（`Icon` 或 `Drawable`）。

---

## 📌 示例：简单拖放操作

### 步骤 1：设置可拖动的 View

```java
TextView textView = findViewById(R.id.draggable_text);
textView.setOnLongClickListener(new View.OnLongClickListener() {
    @Override
    public boolean onLongClick(View v) {
        // 创建 ClipData
        ClipData clip = ClipData.newPlainText("text", "Hello from drag");
        
        // 启动拖放
        v.startDragAndDrop(clip, new View.DragShadowBuilder(v), null, 0);
        return true;
    }
});
```

### 步骤 2：设置目标 View 并监听拖放事件

```java
View targetView = findViewById(R.id.drop_target);
targetView.setOnDragListener(new View.OnDragListener() {
    @Override
    public boolean onDrag(View v, DragEvent event) {
        switch (event.getAction()) {
            case DragEvent.ACTION_DRAG_STARTED:
                // 拖动开始
                Log.d("DragDrop", "Drag started");
                return true;

case DragEvent.ACTION_DRAG_ENTERED:
                // 拖动进入目标区域
                v.setBackgroundColor(Color.GREEN);
                return true;

case DragEvent.ACTION_DRAG_EXITED:
                // 拖动离开目标区域
                v.setBackgroundColor(Color.WHITE);
                return true;

case DragEvent.ACTION_DROP:
                // 拖放完成
                ClipData data = event.getClipData();
                if (data != null && data.getItemCount() > 0) {
                    String text = data.getItemAt(0).getText().toString();
                    Toast.makeText(getApplicationContext(), "Dropped: " + text, Toast.LENGTH_SHORT).show();
                }
                return true;

case DragEvent.ACTION_DRAG_ENDED:
                // 拖动结束
                v.setBackgroundColor(Color.WHITE);
                return true;
        }

return false;
    }
});
```

---

## 📝 注意事项

- `startDragAndDrop()` 需要用户触发（例如长按），不能直接调用。
- 如果你使用的是旧版 Android（< API 31），可以使用 `startDrag()` 替代。
- 使用 `DragShadowBuilder` 可以自定义拖动时的阴影效果。
- 拖放事件只能在同一个应用内进行，跨应用需要额外权限。

---

## 🚀 更多高级功能

- 自定义拖动阴影（`DragShadowBuilder`）
- 多个拖放目标（多个 `View` 监听拖放事件）
- 支持多种数据格式（如文本、URI、Bitmap）

---

## 📚 参考文档

- [Android Drag and Drop API (官方文档)](https://developer.android.com/guide/topics/ui/drag-and-drop)

---

如果你有具体的场景或问题（比如在 `RecyclerView` 中实现拖放、支持多选等），欢迎告诉我，我可以提供更详细的解决方案！