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

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

EventListener

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

DragSourceAdapter, 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)

カーソルのホットスポットがプラットフォーム依存のドロップサイトを入力したときに呼び出されます。このメソッドは、次の条件がすべて満たされたときに呼び出されます。

• カーソルのホットスポットがプラットフォーム依存のドロップサイトの操作可能な部分に入る
• ドロップサイトがアクティブである
• ドロップサイトがドラッグを受け入れる

パラメータ:

dsde - DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent dsde)

カーソルのホットスポットがプラットフォーム依存のドロップサイトに移動したときに呼び出されます。このメソッドは、次の条件がすべて満たされたときに呼び出されます。

• カーソルのホットスポットは移動したが、前の dragEnter() 呼び出しに関連したドロップサイトの操作可能な部分とまだ交差している
• ドロップサイトがまだアクティブである
• ドロップサイトがドラッグを受け入れる

パラメータ:

dsde - DragSourceDragEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent dsde)

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

パラメータ:

dsde - DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent dse)

カーソルのホットスポットがプラットフォーム依存のドロップサイトを終了したときに呼び出されます。このメソッドは、次の条件のどれかが満たされたときに呼び出されます。

• カーソルのホットスポットが、前の dragEnter() 呼び出しに関連したドロップサイトの操作可能な部分と交差しなくなった

または

• 前の dragEnter() 呼び出しに関連したドロップサイトがアクティブでなくなった

または

• 現在のドロップサイトでドラッグが拒否された

パラメータ:

dse - DragSourceEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent dsde)

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

パラメータ:

dsde - DragSourceDropEvent