java.awt.dnd
インタフェース DropTargetListener

すべてのスーパーインタフェース:

EventListener

既知の実装クラスの一覧:

DropTarget

public interface DropTargetListener

extends EventListener

DropTargetListener インタフェースは、対象の DropTarget を含む DnD 操作の通知を DropTarget クラスが提供するのに使うコールバックインタフェースです。このインタフェースのメソッドを実装すると、ドラッグ＆ドロップ操作中に視覚的な「ドラッグアンダー」フィードバックをユーザに提供できます。

導入されたバージョン:

1.2

メソッドの概要

void	dragEnter(DropTargetDragEvent dtde) ドラッグ操作が DropTarget を検出したときに呼び出されます。
void	dragExit(DropTargetEvent dte) ドラッグ操作がドロップなしで DropTarget から離れました。
void	dragOver(DropTargetDragEvent dtde) ドラッグ操作が DropTarget で進行中のときに呼び出されます。
void	drop(DropTargetDropEvent dtde) この DropTarget へのドロップで、ドラッグ操作が終了しました。
void	dropActionChanged(DropTargetDragEvent dtde) ユーザが現在のドロップジェスチャーを変更した場合に呼び出されます。

メソッドの詳細

dragEnter

public void dragEnter(DropTargetDragEvent dtde)

ドラッグ操作が DropTarget を検出したときに呼び出されます。

パラメータ:

dtde - DropTargetDragEvent

dragOver

public void dragOver(DropTargetDragEvent dtde)

ドラッグ操作が DropTarget で進行中のときに呼び出されます。

パラメータ:

dtde - DropTargetDragEvent

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

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

パラメータ:

dtde - DropTargetDragEvent

dragExit

public void dragExit(DropTargetEvent dte)

ドラッグ操作がドロップなしで DropTarget から離れました。

パラメータ:

dte - DropTargetEvent

drop

public void drop(DropTargetDropEvent dtde)

この DropTarget へのドロップで、ドラッグ操作が終了しました。このメソッドは、ジェスチャーに関連したデータの確実な変換を担当します。DropTargetDropEvent は、変換対象のデータオブジェクトを表す Transferable オブジェクトを取得する手段を提供します。

DropTargetDropEvent パラメータの acceptDrop(int dropAction) メソッドまたは rejectDrop() メソッドを使って、DropTargetListener は このメソッドからドロップを受け入れるか、または拒否します。

acceptDrop() より前ではなく後に、DropTargetDropEvent の getTransferable() メソッドが呼び出され、返された Transferable の getTransferData() メソッドを使ってデータ変換が行われます。

ドロップの完了時には、このメソッドの実装は、DropTargetDropEvent の dropComplete(boolean success) に該当の boolean を渡すことによって、ドロップの成功または失敗を通知する必要があります。

注: 実際のデータ変換の処理は、このメソッドが返す前に終了する必要はありません。後に延びてもかまいません。

パラメータ:

dtde - DropTargetDropEvent