モジュール java.desktop
パッケージ java.awt.dnd

クラスDragSourceAdapter

  • すべての実装されたインタフェース:
    DragSourceListener, DragSourceMotionListener, EventListener

    public abstract class DragSourceAdapter
extends Object
implements DragSourceListener, DragSourceMotionListener
    ドラッグ・ソース・イベントを受け取る抽象アダプタ・クラスです。 このクラスのメソッドはすべて空です。 このクラスは、リスナー・オブジェクトの作成を容易にするためだけに提供されています。

    DragSourceEventリスナーを作成し、目的のイベントのためのメソッドをオーバーライドするには、このクラスを拡張します。 (DragSourceListenerインタフェースを実装する場合は、そこに含まれるすべてのメソッドを定義する必要があります。 この抽象クラスは、実装が必要なすべてのメソッドについて空の定義をしているので、必要なイベント用のメソッドを定義するだけで済みます。

    拡張されたクラスを使用してリスナー・オブジェクトを作成し、それをDragSourceに登録します。 ドラッグによってドロップ・サイトが入力、移動、または終了されたり、ドロップ・アクションが変更されたり、あるいはドラッグが終了したりすると、リスナー・オブジェクトの関連するメソッドが呼び出され、そのメソッドにDragSourceEventが渡されます。

    このアダプタのdragEnter()の最後の呼出しがドロップ・サイトに対応し、このアダプタのdragExit()の呼出しがあとに続かない場合は、ドロップ・サイトは前のdragEnter()の呼出しに関連付けられます。

    導入されたバージョン:
    1.4
    関連項目:
    DragSourceEvent, DragSourceListener, DragSourceMotionListener

    • コンストラクタの詳細

      • DragSourceAdapter

        public DragSourceAdapter​()

    • メソッドの詳細

      • dragEnter

        public void dragEnter​(DragSourceDragEvent dsde)
        カーソルのホット・スポットがプラットフォーム依存のドロップ・サイトを入力したときに呼び出されます。 このメソッドは、次の条件がすべて満たされたときに呼び出されます。
        • カーソルのホット・スポットがプラットフォーム依存のドロップ・サイトの操作可能な部分に入る
        • ドロップ・サイトがアクティブである
        • ドロップ・サイトがドラッグを受け入れる
        定義:
        dragEnter、インタフェース: DragSourceListener
        パラメータ:
        dsde - DragSourceDragEvent

      • dragOver

        public void dragOver​(DragSourceDragEvent dsde)
        カーソルのホット・スポットがプラットフォーム依存のドロップ・サイトに移動したときに呼び出されます。 このメソッドは、次の条件がすべて満たされたときに呼び出されます。
        • カーソルのホット・スポットは移動したが、前のdragEnter()呼出しに関連したドロップ・サイトの操作可能な部分とまだ交差している
        • ドロップ・サイトがまだアクティブである
        • ドロップ・サイトがドラッグを受け入れる
        定義:
        dragOver、インタフェース: DragSourceListener
        パラメータ:
        dsde - DragSourceDragEvent

      • dropActionChanged

        public void dropActionChanged​(DragSourceDragEvent dsde)
        ユーザーがドロップ・ジェスチャを変更したときに呼び出されます。 このメソッドは、ユーザーが使用している入力デバイスの状態が変更になった場合に呼び出されます。 このようなデバイスは、通常、ユーザーが使用するマウス・ボタンまたはキーボード修飾子となります。
        定義:
        dropActionChanged、インタフェース: DragSourceListener
        パラメータ:
        dsde - DragSourceDragEvent

      • dragExit

        public void dragExit​(DragSourceEvent dse)
        カーソルのホット・スポットがプラットフォーム依存のドロップ・サイトを終了したときに呼び出されます。 このメソッドは、次の条件のどれかが満たされたときに呼び出されます。
        • カーソルのホット・スポットが、前のdragEnter()呼出しに関連したドロップ・サイトの操作可能な部分と交差しなくなった
        または
        • 前のdragEnter()呼出しに関連したドロップ・サイトがアクティブでなくなった
        または
        • 前のdragEnter()呼出しに関連したドロップ・サイトでドラッグが拒否された
        定義:
        dragExit、インタフェース: DragSourceListener
        パラメータ:
        dse - DragSourceEvent

      • dragDropEnd

        public void dragDropEnd​(DragSourceDropEvent dsde)
        このメソッドの起動により、ドラッグ&ドロップ操作が完了したことを示します。 DragSourceDropEventのgetDropSuccess()メソッドを使用すると、終了状態を判定できます。 getDropAction()メソッドは、Drop操作に適用するため、ドロップ・サイトが選択した操作を返します。 このメソッドが完了すると、現在のDragSourceContextとそれに関連付けられたリソースが無効になります。
        定義:
        dragDropEnd、インタフェース: DragSourceListener
        パラメータ:
        dsde - DragSourceDropEvent