java.awt.dnd

クラス DragSourceAdapter

java.lang.Object

java.awt.dnd.DragSourceAdapter

すべての実装されたインタフェース:

DragSourceListener, DragSourceMotionListener, EventListener

public abstract class DragSourceAdapter
extends Object
implements DragSourceListener, DragSourceMotionListener

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

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

拡張されたクラスを使用してリスナーオブジェクトを作成し、それを 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) ユーザーがドロップジェスチャーを変更したときに呼び出されます。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

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