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
- 関連項目:
DragSourceEvent
,DragSourceListener
,DragSourceMotionListener
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 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)
ユーザーがドロップ・ジェスチャを変更したときに呼び出されます。
-
コンストラクタの詳細
-
DragSourceAdapter
public 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()呼出しに関連したドロップ・サイトの操作可能な部分と交差しなくなった
- 前のdragEnter()呼出しに関連したドロップ・サイトがアクティブでなくなった
- 前のdragEnter()呼出しに関連したドロップ・サイトでドラッグが拒否された
- 定義:
dragExit
、インタフェース:DragSourceListener
- パラメータ:
dse
-DragSourceEvent
-
dragDropEnd
public void dragDropEnd(DragSourceDropEvent dsde)このメソッドの起動により、ドラッグ&ドロップ操作が完了したことを示します。DragSourceDropEvent
のgetDropSuccess()メソッドを使用すると、終了状態を判定できます。 getDropAction()メソッドは、Drop操作に適用するため、ドロップ・サイトが選択した操作を返します。 このメソッドが完了すると、現在のDragSourceContext
とそれに関連付けられたリソースが無効になります。- 定義:
dragDropEnd
、インタフェース:DragSourceListener
- パラメータ:
dsde
-DragSourceDropEvent
-