Version: 2019.4
言語: 日本語
イベントへの応答
イベントの統合

ドラッグアンドドロップのサポート

ドラッグアンドドロップ機能を実装するには、ドロップ領域の VisualElement とドラッグ可能な VisualElement が特定のイベントのコールバックを登録する必要があります。このページでは、これらの VisualElement がイベントを受け取ったときに何が起こるかを説明します。

イベントの詳細については、The Event System のドキュメントを参照してください。

ドロップ領域のコールバックの登録

ドロップ領域となる VisualElement は、以下の 5 つのイベントタイプのコールバックを登録する必要があります。

DragEnterEvent

DragEnterEvent は、ユーザーがドラッグ可能なオブジェクトをドラッグする際に、そのポインターが VisualElement に入ったときに送信されます。

ドロップ領域の VisualElement が DragEnterEvent を受け取ると、フィードバックを提供して、その要素、またはその子の 1 つがドロップ操作のターゲットであることをユーザーに知らせる必要があります。

これは、例えば、USS クラスをターゲット要素に追加し、ドラッグされたオブジェクトの “ゴースト” をマウスポインターの下に表示する方法などで行います。

DragLeaveEvent

DragLeaveEvent は、ユーザーがドラッグ可能なオブジェクトをドラッグして、ポインターが VisualElement を離れるときに送信されます。

ドロップエリア VisualElement が DragLeaveEvent を受信すると、ドロップのフィードバックの提供を停止する必要があります。

これを行うには、例えば、 ターゲット要素が DragEnterEvent を受け取ったときに追加した USS クラスを排除し、ドラッグしたオブジェクトの “ゴースト” を表示しないようにします。

DragUpdatedEvent

DragUpdatedEvent は、ユーザーがドラッグ可能なオブジェクトをドラッグする際に、そのポインターが VisualElement に重なるときに送信されます。

ドロップエリア VisualElement が DragUpdatedEvent を受信すると、ドロップのフィードバックを更新する必要があります。

これは、例えば、ドラッグしたオブジェクトの “ゴースト” を移動して、マウスポインターの下に留まるような方法で行えます。

ドロップ領域の VisualElement は DragAndDrop プロパティを確認して DragAndDrop.visualMode プロパティを設定し、ドロップ操作の効果を示します。例えば、ドロップ操作には、新しいオブジェクトの作成、既存のオブジェクトの移動、ドロップ操作の拒否などが可能です。

DragPerformEvent

DragPerformEvent は、ユーザーがドラッグ可能なオブジェクトをドラッグし、VisualElement の上でマウスポインターを離したときに送信されます。これは、VisualElement が DragAndDrop.visualModeDragAndDropVisualMode.NoneDragAndDropVisualMode.Rejected 以外のものに設定して、ドラッグしたオブジェクトが受け入れ可能であることを示す場合にのみ発生します。

ドロップエリア VisualElement が DragPerformEvent を受信する場合、DragAndDrop.objectReferencesDragAndDrop.pathsDragAndDrop.GetGenericData() のいずれかに保存されているドラックされたオブジェクト上で適切なアクションを行う必要があります。

例えば、 ユーザーがオブジェクトをドロップした場所に新しい VisualElement を加える場合があります。

DragExitedEvent

DragExitedEvent は、ユーザーがドラッグ可能なオブジェクトを VisualElement 上にドラッグし、マウスポインターを離すときに送信されます。これは、ドラッグされたオブジェクトを受け入れることができる VisualElement がない場合にのみ発生します。

ドロップエリアの VisualElement が DragExitedEvent を受信すると、すべてのドラッグアンドドロップのフィードバックを削除する必要があります。

ノート: UIElement には現在 DragExitedEvent 送信を妨げるバグがあります。回避策として、DragLeaveEvent にドラッグアンドドロップ操作を停止するときに送信される関連機能を実装することが可能です。

VisualElement をドラッグ可能にする

VisualElement をドラッグ可能にするには、以下の 3 つのイベントタイプでコールバックを登録する必要があります。

MouseDownEvent

ドラッグ可能な VisualElement が MouseDownEvent を受信する場合、その状態を “ドラッグ可能” に設定する必要があります。

MouseUpEvent

ドラッグ可能な VisualElement が MouseUpEvent を受信する場合、その状態をリセットする必要があります。

MouseMoveEvent

ドラッグ可能な VisualElement が MouseMoveEvent を受信し、ドラッグの準備ができたら、以下が必要です。

  • 状態を “ドラッグ中” に設定します。
  • DragAndDrop に適切なデータを加えます。
  • DragAndDrop.StartDrag() を呼び出します。
  • ドラッグ操作の対象であることを視覚的にフィードバックします。

    ドロップエリアの VisualElement が DragPerformEvent または DragExitedEvent を受信するときに、このフィードバックを除く必要があります。
イベントへの応答
イベントの統合
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961