クラスDragSourceAdapter

java.lang.Object
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
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    protected
    DragSourceAdapter()
    DragSourceAdapterを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    dragDropEnd(DragSourceDropEvent dsde)
    このメソッドの起動により、ドラッグ&ドロップ操作が完了したことを示します。
    void
    dragEnter(DragSourceDragEvent dsde)
    カーソルのホット・スポットがプラットフォーム依存のドロップ・サイトを入力したときに呼び出されます。
    void
    dragExit(DragSourceEvent dse)
    カーソルのホット・スポットがプラットフォーム依存のドロップ・サイトを終了したときに呼び出されます。
    void
    dragMouseMoved(DragSourceDragEvent dsde)
    ドラッグ操作中にマウスが移動したときに呼び出されます。
    void
    dragOver(DragSourceDragEvent dsde)
    カーソルのホット・スポットがプラットフォーム依存のドロップ・サイトに移動したときに呼び出されます。
    void
    dropActionChanged(DragSourceDragEvent dsde)
    ユーザーがドロップ・ジェスチャを変更したときに呼び出されます。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • DragSourceAdapter

      protected DragSourceAdapter()
      DragSourceAdapterを構築します。

  • メソッドの詳細

    • dragEnter

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

    • dragOver

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

    • dragMouseMoved

      public void dragMouseMoved(DragSourceDragEvent dsde)
      ドラッグ操作中にマウスが移動したときに呼び出されます。
      定義:
      dragMouseMoved、インタフェースDragSourceMotionListener
      パラメータ:
      dsde - DragSourceDragEvent

    • dropActionChanged

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

    • dragExit

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

    • dragDropEnd

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