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