java.awt.dnd
クラス DropTargetAdapter

java.lang.Object
  java.awt.dnd.DropTargetAdapter

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

DropTargetListener, EventListener

public abstract class DropTargetAdapter
extends Object
implements DropTargetListener

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

DropTargetEvent リスナーを作成するには、このクラスを拡張して関連イベントに対するメソッドをオーバーライドします。DropTargetListener インタフェースを実装する場合は、その中のメソッドをすべて定義する必要があります。この abstract クラスは、drop(DropTargetDropEvent) 以外のすべてのメソッドについて空の実装を定義しているので、必要なイベント用のメソッドを定義するだけで済みます。少なくとも drop(DropTargetDropEvent) の実装は提供する必要があります。仕様上、ドロップを受け入れるか拒否するか、受け入れる場合はドロップが成功したかどうかを示す必用があるため、このメソッドの実装を空にすることはできません。

拡張したクラスを使ってリスナーオブジェクトを作成後、リスナーオブジェクトを DropTarget に登録します。ドラッグによって DropTarget のドロップサイトの操作可能な部分が入力、移動、または終了されたり、ドロップアクションが変更されたり、ドロップが発生したりすると、リスナーオブジェクトの関連するメソッドが呼び出され、そのメソッドに DropTargetEvent が渡されます。

DropTarget のドロップサイトの操作可能な部分とは、関連する Component の幾何学的図形の一部で、重なっている最上位のウィンドウや、関連するアクティブな DropTarget を持つ、Z-Order が高位である別の Component で隠されていない部分のことです。

ドラッグ時に、現在のドラッグ操作に関連するデータは、リスナーのメソッドに渡される DropTargetDragEvent インスタンスで getTransferable() を呼び出すことによって、取得できます。

DropTargetDragEvent インスタンスの getTransferable() は、各リスナーのメソッド内でのみ呼び出す必要があり、そのメソッドが戻る前に、返される Transferable からすべての必要なデータを取得する必要があることに注意してください。

導入されたバージョン:

1.4

関連項目:

DropTargetEvent, DropTargetListener

コンストラクタの概要

DropTargetAdapter()

メソッドの概要

void	dragEnter(DropTargetDragEvent dtde) ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分にマウスポインタが入ったときに呼び出されます。
void	dragExit(DropTargetEvent dte) ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分からマウスポインタが出たときに呼び出されます。
void	dragOver(DropTargetDragEvent dtde) ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分にマウスポインタがまだあるときに呼び出されます。
void	dropActionChanged(DropTargetDragEvent dtde) ユーザーが現在のドロップジェスチャーを変更した場合に呼び出されます。

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

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

インタフェース java.awt.dnd.DropTargetListener から継承されたメソッド

drop

コンストラクタの詳細

DropTargetAdapter

public DropTargetAdapter()

メソッドの詳細

dragEnter

public void dragEnter(DropTargetDragEvent dtde)

ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分にマウスポインタが入ったときに呼び出されます。

定義:

インタフェース DropTargetListener 内の dragEnter

パラメータ:

dtde - DropTargetDragEvent

dragOver

public void dragOver(DropTargetDragEvent dtde)

ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分にマウスポインタがまだあるときに呼び出されます。

定義:

インタフェース DropTargetListener 内の dragOver

パラメータ:

dtde - DropTargetDragEvent

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

ユーザーが現在のドロップジェスチャーを変更した場合に呼び出されます。

定義:

インタフェース DropTargetListener 内の dropActionChanged

パラメータ:

dtde - DropTargetDragEvent

dragExit

public void dragExit(DropTargetEvent dte)

ドラッグ操作中に、リスナーに登録された DropTarget のドロップサイトの操作可能な部分からマウスポインタが出たときに呼び出されます。

定義:

インタフェース DropTargetListener 内の dragExit

パラメータ:

dte - DropTargetEvent