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

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

EventListener

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

DragSourceContext

public interface DragSourceListener

extends EventListener

DragSourceListener は、ドラッグ＆ドロップ操作に関するオリジネータのイベントインタフェースを定義して、ユーザのジェスチャーの状態を監視したり、ドラッグ＆ドロップ操作全体の最適な「ドラッグオーバー」フィードバックをユーザに提供します。

導入されたバージョン:

1.2

メソッドの概要

void	dragDropEnd(DragSourceDropEvent dsde) このメソッドの起動により、ドラッグ＆ドロップ操作が完了したことを示します。
void	dragEnter(DragSourceDragEvent dsde) ホットスポットとして呼び出され、プラットフォーム依存のドロップサイトを入力します。
void	dragExit(DragSourceEvent dse) ホットスポットとして呼び出され、プラットフォーム依存のドロップサイトを終了します。
void	dragOver(DragSourceDragEvent dsde) ホットスポットとして呼び出され、プラットフォーム依存のドロップサイトに移動します。
void	dropActionChanged(DragSourceDragEvent dsde) ユーザがドロップジェスチャーを修正したときに呼び出されました。

メソッドの詳細

dragEnter

public void dragEnter(DragSourceDragEvent dsde)

ホットスポットとして呼び出され、プラットフォーム依存のドロップサイトを入力します。このメソッドは、次の条件が当てはまる場合に起動されます。

• 論理カーソルのホットスポットは、最初に GUI Component の可視ジオメトリと交差する
• その Component には、関連したアクティブな DropTarget がある
• DropTarget で登録した DropTargetListener の dragEnter() メソッドが起動され、問題なく返される
• 登録されている DropTargetListener が DropTargetDragEvent の acceptDrag() メソッドを起動し、転送元の潜在的なドロップアクションの調査、および有効なデータタイプ (DataFlavor) に応じてドラッグを受け入れる

パラメータ:

dsde - DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent dsde)

ホットスポットとして呼び出され、プラットフォーム依存のドロップサイトに移動します。このメソッドは、次の条件が当てはまる場合に起動されます。

• カーソルの論理ホットスポットは移動したが、前の dragEnter() 呼び出しに関連した Component の可視ジオメトリとまだ交差している
• その Component には、関連した DropTarget がある
• その DropTarget がまだアクティブである
• DropTarget で登録した DropTargetListener の dragOver() メソッドが起動され、問題なく返される
• DropTarget は rejectDrag() を介してドラッグを受け入れる

パラメータ:

dsde - DragSourceDragEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent dsde)

ユーザがドロップジェスチャーを修正したときに呼び出されました。このメソッドは、ユーザが使用している入力デバイスの状態が変更になった場合に呼び出されます。このようなデバイスは、通常、ユーザが使用するマウスボタンまたはキーボード修飾子となります。

パラメータ:

dsde - DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent dse)

ホットスポットとして呼び出され、プラットフォーム依存のドロップサイトを終了します。このメソッドは、次の条件が当てはまる場合に起動されます。

• カーソルの論理ホットスポットは、前の dragEnter() 呼び出しに関連した Component の可視ジオメトリと交差していない

または

• 論理カーソルのホットスポットが交差し、前の dragEnter() 呼び出しを引き起こした Component には、関連したアクティブな DropTarget または DropTargetListener がない

または

• 現在の DropTarget の DropTargetListener は、最後に dragEnter() または dragOver() を呼び出した後、rejectDrag() を起動している

パラメータ:

dse - DragSourceEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent dsde)

このメソッドの起動により、ドラッグ＆ドロップ操作が完了したことを示します。DragSourceDropEvent の getDropSuccess() メソッドを使用して、終了状態を決めることができます。getDropAction() メソッドは、Drop 操作に適用するため、DropTargetDropEvent の acceptDrop() パラメータ経由で DropTarget が選択された操作を返します。このメソッドが完了すると、現在の DragSourceContext および関連するリソースは無効となります。

パラメータ:

dsde - DragSourceDropEvent