java.awt.dnd
クラス DragSourceEvent

java.lang.Object
  java.util.EventObject
      java.awt.dnd.DragSourceEvent

すべての実装されたインタフェース:

Serializable

直系の既知のサブクラス:

DragSourceDragEvent, DragSourceDropEvent

public class DragSourceEvent
extends EventObject

このクラスは、DragSourceDragEvent および DragSourceDropEvent の基底クラスです。

DragSourceEvent は、ドラッグによってドロップサイトが入力、移動、または終了されたり、ドロップアクションが変更されたり、ドラッグが終了したりすると、常に生成されます。DragSourceEvent が生成された位置によって、このイベントが発生したときの画面座標内のマウスカーソルの位置が指定されます。

仮想デバイスを持たないマルチスクリーン環境では、カーソル位置はイニシエータ GraphicsConfiguration の座標体系で指定されます。イニシエータ GraphicsConfiguration は、現在のドラッグ操作のドラッグジェスチャーが認識された Component の GraphicsConfiguration です。カーソル位置がイニシエータ GraphicsConfiguration の境界の外側にある場合、通知される座標は GraphicsConfiguration の境界の内側に収まるようにクリップされます。

仮想デバイスを持つマルチスクリーン環境では、位置は対応する仮想座標体系で指定されます。カーソル位置が仮想デバイスの境界の外側にある場合、通知される座標は仮想デバイスの境界の内側に収まるようにクリップされます。

導入されたバージョン:

1.2

関連項目:

直列化された形式

フィールドの概要

クラス java.util.EventObject から継承されたフィールド

source

コンストラクタの概要

DragSourceEvent(DragSourceContext dsc)
指定された DragSourceContext に提供された DragSourceEvent を構築します。

DragSourceEvent(DragSourceContext dsc, int x, int y)
指定された DragSourceContext とカーソル位置の座標に提供された DragSourceEvent を構築します。

メソッドの概要

DragSourceContext	getDragSourceContext() このメソッドは、イベントを発生させた DragSourceContext を返します。
Point	getLocation() このメソッドは、このイベントが発生したときの画面座標のカーソル位置を示す Point を返し、このイベントにカーソル位置が指定されていない場合は null を返します。
int	getX() このメソッドは、このイベントが発生したときの画面座標のカーソル位置の水平座標を返し、このイベントにカーソル位置が指定されていない場合は 0 を返します。
int	getY() このメソッドは、このイベントが発生したときの画面座標のカーソル位置の垂直座標を返し、このイベントにカーソル位置が指定されていない場合は 0 を返します。

クラス java.util.EventObject から継承されたメソッド

getSource, toString

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

DragSourceEvent

public DragSourceEvent(DragSourceContext dsc)

指定された DragSourceContext に提供された DragSourceEvent を構築します。この DragSourceEvent の座標は指定されないため、getLocation はこのイベントに対して null を返します。

パラメータ:

dsc - DragSourceContext

例外:

IllegalArgumentException - dsc が null の場合

関連項目:

getLocation()

DragSourceEvent

public DragSourceEvent(DragSourceContext dsc,
                       int x,
                       int y)

指定された DragSourceContext とカーソル位置の座標に提供された DragSourceEvent を構築します。

パラメータ:

dsc - DragSourceContext

x - カーソル位置の水平座標

y - カーソル位置の垂直座標

例外:

IllegalArgumentException - dsc が null の場合

導入されたバージョン:

1.4

メソッドの詳細

getDragSourceContext

public DragSourceContext getDragSourceContext()

このメソッドは、イベントを発生させた DragSourceContext を返します。

戻り値:

イベントを発生させた DragSourceContext

getLocation

public Point getLocation()

このメソッドは、このイベントが発生したときの画面座標のカーソル位置を示す Point を返し、このイベントにカーソル位置が指定されていない場合は null を返します。

戻り値:

カーソル位置を示す Point。カーソル位置が指定されていない場合は null

導入されたバージョン:

1.4

getX

public int getX()

このメソッドは、このイベントが発生したときの画面座標のカーソル位置の水平座標を返し、このイベントにカーソル位置が指定されていない場合は 0 を返します。

戻り値:

カーソル位置の水平座標を示す整数値。カーソル位置が指定されていない場合は 0

導入されたバージョン:

1.4

getY

public int getY()

このメソッドは、このイベントが発生したときの画面座標のカーソル位置の垂直座標を返し、このイベントにカーソル位置が指定されていない場合は 0 を返します。

戻り値:

カーソル位置の垂直座標を示す整数値。カーソル位置が指定されていない場合は 0

導入されたバージョン:

1.4