java.awt.dnd

インタフェース DragSourceListener

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

EventListener

既知のすべての実装クラス:

DragSourceAdapter、DragSourceContext

public interface DragSourceListener
extends EventListener

DragSourceListener は、ドラッグ&ドロップ操作のオリジネータがユーザーのジェスチャーの状態を追跡するためのイベントインタフェースを定義し、ユーザーにドラッグ&ドロップ操作を通した適切な「ドラッグオーバー」フィードバックを提供します。

ドロップサイトは、このリスナーに対する dragEnter() の最後の呼び出しが次の場合、以前の dragEnter() の呼び出しに関連付けられます。

• そのドロップサイトに対応する
• このリスナーの dragExit() の呼び出しがあとに続かない

導入されたバージョン:

1.2

メソッドのサマリー

メソッド

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

メソッドの詳細

dragEnter

void dragEnter(DragSourceDragEvent dsde)

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

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

パラメータ:

dsde - DragSourceDragEvent

dragOver

void dragOver(DragSourceDragEvent dsde)

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

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

パラメータ:

dsde - DragSourceDragEvent

dropActionChanged

void dropActionChanged(DragSourceDragEvent dsde)

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

パラメータ:

dsde - DragSourceDragEvent

dragExit

void dragExit(DragSourceEvent dse)

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

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

または

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

または

• 前の dragEnter() 呼び出しに関連したドロップサイトでドラッグが拒否された

パラメータ:

dse - DragSourceEvent

dragDropEnd

void dragDropEnd(DragSourceDropEvent dsde)

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

パラメータ:

dsde - DragSourceDropEvent