すべてのスーパー・インタフェース:: 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()呼出しに関連したドロップ・サイトの操作可能な部分と交差しなくなった
  OR
  
  前のdragEnter()呼出しに関連したドロップ・サイトがアクティブでなくなった
  OR
  
  前のdragEnter()呼出しに関連したドロップ・サイトでドラッグが拒否された
  パラメータ:
  
  dse - DragSourceEvent
- dragDropEnd
  
  void dragDropEnd(DragSourceDropEvent dsde)
  
  このメソッドの起動により、ドラッグ&ドロップ操作が完了したことを示します。 DragSourceDropEventのgetDropSuccess()メソッドを使用すると、終了状態を判定できます。 getDropAction()メソッドは、Drop操作に適用するため、ドロップ・サイトが選択した操作を返します。このメソッドが完了すると、現在のDragSourceContextとそれに関連付けられたリソースが無効になります。
  
  パラメータ:
  
  dsde - DragSourceDropEvent

インタフェースDragSourceListener

メソッドのサマリー

メソッドの詳細

dragEnter

dragOver

dropActionChanged

dragExit

dragDropEnd