java.awt.dnd

クラス DragGestureEvent

java.lang.Object

java.util.EventObject

java.awt.dnd.DragGestureEvent

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

Serializable

public class DragGestureEvent
extends EventObject

DragGestureEvent は、特定の DragGestureRecognizer が、追跡している Component でプラットフォーム依存のドラッグ開始ジェスチャーが発生したことを検出したときに、DragGestureListener の dragGestureRecognized() メソッドに渡されます。 DragGestureEvent インスタンスの action フィールドは、次のいずれかの値を取ります。

• DnDConstants.ACTION_COPY
• DnDConstants.ACTION_MOVE
• DnDConstants.ACTION_LINK

上記以外の値を割り当てると、不特定の動作が発生します。

関連項目:

DragGestureRecognizer, DragGestureListener, DragSource, DnDConstants, 直列化された形式

フィールドのサマリー

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

source

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
DragGestureEvent(DragGestureRecognizer dgr, int act, Point ori, List<? extends InputEvent> evs) このイベントをトリガーする DragGestureRecognizer インスタンス、ユーザーの希望するアクションを表す act パラメータ、ドラッグの起点を示す ori パラメータ、およびジェスチャーを構成するイベントの List (evs パラメータ) を使用して、DragGestureEvent オブジェクトを構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Component	getComponent() この DragGestureEvent に関連付けられた Component を返します。
int	getDragAction() ユーザーによって選択されたアクションを表す int を返します。
Point	getDragOrigin() ドラッグを開始した Component の座標の Point を返します。
DragSource	getDragSource() DragSource を返します。
DragGestureRecognizer	getSourceAsDragGestureRecognizer() ソースを DragGestureRecognizer として返します。
InputEvent	getTriggerEvent() ジェスチャーをトリガーした初期イベントを返します。
Iterator<InputEvent>	iterator() ジェスチャーを構成しているイベントの Iterator を返します。
void	startDrag(Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl) 表示する初期の Cursor、ドラッグ Image、Image のオフセット、Transferable オブジェクト、および使用する DragSourceListener で、ドラッグを開始します。
void	startDrag(Cursor dragCursor, Transferable transferable) このドラッグ操作の Cursor、およびこのドラッグ操作のソースデータを表す Transferable を使用して、ドラッグ操作を開始します。
void	startDrag(Cursor dragCursor, Transferable transferable, DragSourceListener dsl) 表示する初期の Cursor、Transferable オブジェクト、および使用する DragSourceListener を使用して、ドラッグを開始します。
Object[]	toArray() ドラッグジェスチャーを構成しているイベントの Object 配列を返します。
Object[]	toArray(Object[] array) ドラッグジェスチャーを構成するイベントの配列を返します。

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

getSource, toString

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

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

コンストラクタの詳細

DragGestureEvent

public DragGestureEvent(DragGestureRecognizer dgr,
                int act,
                Point ori,
                List<? extends InputEvent> evs)

このイベントをトリガーする DragGestureRecognizer インスタンス、ユーザーの希望するアクションを表す act パラメータ、ドラッグの起点を示す ori パラメータ、およびジェスチャーを構成するイベントの List (evs パラメータ) を使用して、DragGestureEvent オブジェクトを構築します。

パラメータ:

dgr - このイベントをトリガーする DragGestureRecognizer

act - ユーザーの希望するアクション。許容される値については、DragGestureEvent のクラスの説明を参照

ori - ドラッグの起点

evs - ジェスチャーを構成するイベントの List

例外:

IllegalArgumentException - いずれかのパラメータが null に等しい場合

IllegalArgumentException - act パラメータが DragGestureEvent のクラスの説明で指定されている値に従っていない場合

関連項目:

DnDConstants

メソッドの詳細

getSourceAsDragGestureRecognizer

public DragGestureRecognizer getSourceAsDragGestureRecognizer()

ソースを DragGestureRecognizer として返します。

戻り値:

DragGestureRecognizer としてのソース

getComponent

public Component getComponent()

この DragGestureEvent に関連付けられた Component を返します。

戻り値:

Component

getDragSource

public DragSource getDragSource()

DragSource を返します。

戻り値:

DragSource

getDragOrigin

public Point getDragOrigin()

ドラッグを開始した Component の座標の Point を返します。

戻り値:

Component の座標でドラッグが開始された Point

iterator

public Iterator<InputEvent> iterator()

ジェスチャーを構成しているイベントの Iterator を返します。

戻り値:

ジェスチャーを構成するイベントのイテレータ

toArray

public Object[] toArray()

ドラッグジェスチャーを構成しているイベントの Object 配列を返します。

戻り値:

ジェスチャーを構成するイベントの配列

toArray

public Object[] toArray(Object[] array)

ドラッグジェスチャーを構成するイベントの配列を返します。

パラメータ:

array - EventObject サブタイプの配列

戻り値:

ジェスチャーを構成するイベントの配列

getDragAction

public int getDragAction()

ユーザーによって選択されたアクションを表す int を返します。

戻り値:

ユーザーが選択したアクション

getTriggerEvent

public InputEvent getTriggerEvent()

ジェスチャーをトリガーした初期イベントを返します。

戻り値:

ジェスチャーシーケンスでの最初の「トリガー」イベント

startDrag

public void startDrag(Cursor dragCursor,
             Transferable transferable)
               throws InvalidDnDOperationException

このドラッグ操作の Cursor、およびこのドラッグ操作のソースデータを表す Transferable を使用して、ドラッグ操作を開始します。
null の Cursor が指定された場合は、例外はスローされず、代わりにデフォルトのドラッグカーソルが使用されます。
null の Transferable が指定された場合は、NullPointerException がスローされます。

パラメータ:

dragCursor - このドラッグ操作の初期の Cursor。デフォルトのカーソル処理の場合は null。ドラッグ&ドロップ中のカーソル処理メカニズムの詳細は、DragSourceContext を参照してください。

transferable - このドラッグ操作のソースデータを表す Transferable。

例外:

InvalidDnDOperationException - ドラッグ&ドロップシステムがドラッグ操作を開始できない場合、または既存のドラッグ操作を引き続き実行中にユーザーがドラッグを開始しようとした場合。

NullPointerException - Transferable が null である場合

導入されたバージョン:

1.4

startDrag

public void startDrag(Cursor dragCursor,
             Transferable transferable,
             DragSourceListener dsl)
               throws InvalidDnDOperationException

表示する初期の Cursor、Transferable オブジェクト、および使用する DragSourceListener を使用して、ドラッグを開始します。

パラメータ:

dragCursor - このドラッグ操作の初期の Cursor。デフォルトのカーソル処理の場合は null。ドラッグ&ドロップ中のカーソル処理メカニズムの詳細は、DragSourceContext を参照してください。

transferable - ソースの Transferable

dsl - ソースの DragSourceListener

例外:

InvalidDnDOperationException - ドラッグ&ドロップシステムがドラッグ操作を開始できない場合、または既存のドラッグ操作を引き続き実行中にユーザーがドラッグを開始しようとした場合。

startDrag

public void startDrag(Cursor dragCursor,
             Image dragImage,
             Point imageOffset,
             Transferable transferable,
             DragSourceListener dsl)
               throws InvalidDnDOperationException

表示する初期の Cursor、ドラッグ Image、Image のオフセット、Transferable オブジェクト、および使用する DragSourceListener で、ドラッグを開始します。

パラメータ:

dragCursor - このドラッグ操作の初期の Cursor。デフォルトのカーソル処理の場合は null。ドラッグ&ドロップ中のカーソル処理メカニズムの詳細は、DragSourceContext を参照してください。

dragImage - ソースの dragImage

imageOffset - dragImage のオフセット

transferable - ソースの Transferable

dsl - ソースの DragSourceListener

例外:

InvalidDnDOperationException - ドラッグ&ドロップシステムがドラッグ操作を開始できない場合、または既存のドラッグ操作を引き続き実行中にユーザーがドラッグを開始しようとした場合。