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