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) を除くすべてのメソッドに対して null 実装が定義されているため、必要なイベント用のメソッドを定義するだけで済みます。)少なくとも drop(DropTargetDropEvent) の実装を提供する必要があります。仕様上、ドロップを受け入れるか拒否するか、受け入れる場合はドロップが成功したかどうかを示す必用があるため、このメソッドの実装を空にすることはできません。

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

DropTarget のドロップサイトの操作可能な部分とは、関連付けられた Component の幾何学的図形の一部であり、オーバーラップしているトップレベルのウィンドウや、アクティブな DropTarget が関連付けられている Z 軸順で高位の別の 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 のドロップサイトの操作可能な部分に入ったときに呼び出されます。

定義:

dragEnter、インタフェース: DropTargetListener

パラメータ:

dtde - DropTargetDragEvent

dragOver

public void dragOver(DropTargetDragEvent dtde)

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

定義:

dragOver、インタフェース: DropTargetListener

パラメータ:

dtde - DropTargetDragEvent

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

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

定義:

dropActionChanged、インタフェース: DropTargetListener

パラメータ:

dtde - DropTargetDragEvent

dragExit

public void dragExit(DropTargetEvent dte)

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

定義:

dragExit、インタフェース: DropTargetListener

パラメータ:

dte - DropTargetEvent