モジュール java.desktop
パッケージ java.awt.dnd

クラスDropTargetAdapter

java.lang.Object
java.awt.dnd.DropTargetAdapter
すべての実装されたインタフェース:
DropTargetListener, EventListener
public abstract class DropTargetAdapter extends Object implements DropTargetListener
ドロップ・ターゲット・イベントを受け取る抽象アダプタ・クラスです。 このクラス内のメソッドは空です。 このクラスは、リスナー・オブジェクトの作成を容易にするためだけに提供されています。

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

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

DropTargetのドロップ・サイトの操作可能な部分とは、関連付けられたComponentの幾何学的図形の一部であり、オーバーラップしているトップ・レベルのウィンドウや、アクティブなDropTargetが関連付けられているZ軸順で高位の別のComponentによって隠されていない部分のことです。

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

DropTargetDragEventインスタンス上のgetTransferable()は、対応するリスナーのメソッド内でのみ呼び出すようにし、そのメソッドから戻る前に、必要なすべてのデータを返されたTransferableから取得するようにしてください。

導入されたバージョン:
1.4
関連項目: