Android為View新增拖放效果的方法範例

2022-02-18 13:03:25

1.引言

在開發中，拖放是一種比較常見的手勢操作，使用它能夠讓應用的互動更加地便捷和友好，本文將簡要介紹如何為Android中的View新增拖放效果。

2.主要方法和類介紹

2.1 startDragAndDrop()和startDrag()

要實現View的拖放，需要呼叫View的startDragAndDrop()或startDrag()方法，其中startDragAndDrop()方法要求API版本為24或以上，呼叫方法後，View便可以拖動了，此方法需要傳遞的引數如下：

//data：拖放操作要傳遞的資料
//shadowBuilder：拖放陰影
//myLocalState：一個包含與拖放操作有關的資料的物件
//flags：控制拖放操作的標誌位
public final boolean startDragAndDrop(ClipData data, DragShadowBuilder shadowBuilder,Object myLocalState, int flags)

2.2 setOnDragListener()

接收拖放事件的View我們暫且稱之為目標View，目標View呼叫setOnDragListener()，並實現其中的方法onDrag()後可以接收拖放事件的回撥。

2.3 View.DragShadowBuilder

在拖放操作進行的時候，需要顯示正在拖動的圖片，View.DragShadowBuilder類提供了可以傳入View的構造方法，這個View是被拖放的View，我們將通過DragShadowBuilder建立的拖動圖片稱為拖動陰影，這個將作為引數傳入startDragAndDrop()或startDrag()方法中，如若有需要的話，還可以繼承View.DragShadowBuilder類去實現自定義的效果。

2.4 DragEvent

此類主要定義了拖放事件的型別，通過event.getAction()可以獲取不同的事件型別，主要有以下幾種：

//DragEvent.ACTION_DRAG_STARTED:表示拖動已經開始
//DragEvent.ACTION_DRAG_ENTERED:表示拖動陰影已經進入目標View
//DragEvent.ACTION_DRAG_LOCATION：拖動陰影在目標View邊界內移動時會多次響應此事件
//DragEvent.ACTION_DRAG_EXITED：表示拖動陰影離開了目標View的邊界
//DragEvent.ACTION_DROP：表示拖動陰影被釋放
//DragEvent.ACTION_DRAG_ENDED：表示拖放操作即將結束，在此處需要通過呼叫event.getResult()的返回值來判斷拖放操作是否成功

3. 演示將一張圖片拖放到方框內

現在演示將一張圖片拖放到方框內，來說明拖放操作的大致流程，其中方框是一個LinearLayout，為它設定了一個方框背景。

3.1 簡易佈局

佈局如下：

<?xml version="1.0" encoding="utf-8"?>
<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"
    tools:context=".MainActivity">

    <ImageView
        android:id="@+id/iv_drag"
        android:layout_width="100dp"
        android:layout_height="100dp"
        android:layout_centerHorizontal="true"
        android:src="@mipmap/ic_launcher" />

    <LinearLayout
        android:id="@+id/ll_accept"
        android:layout_width="300dp"
        android:layout_height="300dp"
        android:layout_alignParentBottom="true"
        android:layout_centerHorizontal="true"
        android:layout_marginBottom="50dp"
        android:background="@drawable/black_bac"
        android:orientation="vertical">
    </LinearLayout>
</RelativeLayout>

3.2 操作被拖放的圖片

實現長按拖動圖片的效果，首先呼叫setOnLongClickListener()設定長按事件回撥，之後構建ClipData和拖動陰影，然後呼叫startDragAndDrop()或startDrag()方法實現拖動，程式碼如下：

iv_drag.setOnLongClickListener(new View.OnLongClickListener() {
    @Override
    public boolean onLongClick(View v) {
        CharSequence charSequence = (CharSequence) iv_drag.getTag();
        ClipData.Item item = new ClipData.Item(charSequence);
        ClipData clipData = new ClipData(charSequence, new String[]{ClipDescription.MIMETYPE_TEXT_PLAIN}, item);
        View.DragShadowBuilder shadowBuilder = new View.DragShadowBuilder(iv_drag);
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            iv_drag.startDragAndDrop(clipData, shadowBuilder, null, 0);
        } else {
            iv_drag.startDrag(clipData, shadowBuilder, null, 0);
        }
        return true;
    }
});

3.3 方框接收圖片

目標View要接收圖片需要先呼叫setOnDragListener()來接受拖放事件的回撥，使用event.getAction()來獲取不同的拖放事件型別，然後根據事件型別執行相應的操作，範例如下：

ll_accept.setOnDragListener(new View.OnDragListener() {
    @Override
    public boolean onDrag(View v, DragEvent event) {
        switch (event.getAction()) {
            case DragEvent.ACTION_DRAG_STARTED:
                iv_drag.setVisibility(View.GONE);
                if (event.getClipDescription().hasMimeType(ClipDescription.MIMETYPE_TEXT_PLAIN)) {
                    return true;
                }
                return false;

            case DragEvent.ACTION_DRAG_ENTERED:
                isChangePos = true;
                ll_accept.setBackgroundResource(R.drawable.green_bac);
                return true;

            case DragEvent.ACTION_DRAG_LOCATION:
                x = event.getX();
                y = event.getY();
                return true;

            case DragEvent.ACTION_DRAG_EXITED:
                isChangePos = false;
                ll_accept.setBackgroundResource(R.drawable.black_bac);
                return true;

            case DragEvent.ACTION_DROP:

                return true;

            case DragEvent.ACTION_DRAG_ENDED:
                ll_accept.setBackgroundResource(R.drawable.black_bac);
                if (isChangePos && event.getResult()) {
                    int left = ll_accept.getLeft();
                    int top = ll_accept.getTop();
                    x = x + left - (iv_drag.getWidth() / 2);
                    y = y + top - (iv_drag.getHeight() / 2);
                    iv_drag.setX(x);
                    iv_drag.setY(y);
                }
                iv_drag.setVisibility(View.VISIBLE);
                return true;
        }
        return false;
    }
});