java.awt.dnd

クラスDragSourceDragEvent

java.lang.Object

java.util.EventObject

java.awt.dnd.DragSourceEvent

java.awt.dnd.DragSourceDragEvent

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

Serializable

public class DragSourceDragEvent
extends DragSourceEvent

DragSourceDragEventは、DragSourceContextPeerからDragSourceContextを経由して、そのDragSourceContextとそれに関連付けられたDragSourceに登録されたDragSourceListenerに送られます。

DragSourceDragEventは、ドラッグ操作の現在の状態が反映されたターゲット・ドロップ・アクションとユーザー・ドロップ・アクションを報告します。

ターゲット・ドロップ・アクションは、現在のドロップ・ターゲットによって選択されたドロップ・アクションがドラッグ・ソースでサポートされている場合はこのドロップ・アクションを表すDnDConstantsのいずれか、このドロップ・アクションがドラッグ・ソースでサポートされていない場合はDnDConstants.ACTION_NONEです。

ユーザー・ドロップ・アクションは、ドラッグ・ソースでサポートされているドロップ・アクションと、ユーザーによって選択されたドロップ・アクションによって異なります。ユーザーは、ドラッグ操作中に修飾キーを押すことで、ドロップ・アクションを選択できます。

   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE
 

ユーザーがドロップ・アクションを選択した場合、ユーザー・ドロップ・アクションは、このドロップ・アクションがドラッグ・ソースでサポートされている場合は選択されたドロップ・アクションを表すDnDConstantsのいずれか、このドロップ・アクションがドラッグ・ソースでサポートされていない場合はDnDConstants.ACTION_NONEです。

ユーザーがドロップ・アクションを選択しない場合、ドラッグ・ソースでサポートされている一連のドロップ・アクションを表すDnDConstantsのセットからDnDConstants.ACTION_MOVE、DnDConstants.ACTION_COPY、DnDConstants.ACTION_LINKが順に検索され、ユーザー・ドロップ・アクションは最初に見つかった定数です。どの定数も見つからなかった場合、ユーザー・ドロップ・アクションはDnDConstants.ACTION_NONEです。

導入されたバージョン:

1.2

関連項目:

直列化された形式

フィールドのサマリー

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

source

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

コンストラクタ

コンストラクタと説明
DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers) DragSourceDragEventを構築します。
DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y) 指定されたDragSourceContext、ユーザー・ドロップ・アクション、ターゲット・ドロップ・アクション、修飾子、および座標を使用して、DragSourceDragEventを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
int	getDropAction() このメソッドは、ターゲット・ドロップ・アクション、およびドラッグ・ソースでサポートされる一連のドロップ・アクションの論理積を返します。
int	getGestureModifiers() このメソッドは、ユーザーのジェスチャに関連付けられた入力デバイス修飾子の現在の状態を表すintを返します。
int	getGestureModifiersEx() このメソッドは、ユーザーのジェスチャに関連付けられた、拡張された入力デバイス修飾子の現在の状態を表すintを返します。
int	getTargetActions() このメソッドは、ターゲット・ドロップ・アクションを返します。
int	getUserAction() このメソッドは、ユーザー・ドロップ・アクションを返します。

クラス java.awt.dnd.DragSourceEventから継承されたメソッド

getDragSourceContext, getLocation, getX, getY

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

getSource, toString

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

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

コンストラクタの詳細

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int action,
                           int modifiers)

DragSourceDragEventを構築します。このクラスは通常、クライアント・コードによって直接ではなく、DragSourceContextPeerによってインスタンス化されます。このDragSourceDragEventでは座標が指定されないため、getLocationはこのイベントに対してnullを返します。

引数dropActionとactionには、1つのアクションを表すDnDConstantsのいずれかを指定するようにしてください。引数modifiersには、古いjava.awt.event.InputEvent.*_MASK定数のビット単位のマスクか、または拡張されたjava.awt.event.InputEvent.*_DOWN_MASK定数のビット単位のマスクのどちらかを指定するようにしてください。このコンストラクタは、無効なdropAction、action、およびmodifiersに対してどの例外もスローしません。

パラメータ:

dsc - このイベントの通知を管理するためのDragSourceContext。

dropAction - ユーザー・ドロップ・アクション。

action - ターゲット・ドロップ・アクション。

modifiers - イベント発生時に押された修飾キー(Shift、Ctrl、Alt、メタ)。拡張された_DOWN_MASKまたは古い_MASK修飾子のどちらかを使用するべきですが、1つのイベントで両方のモデルを混在させてはいけません。拡張された修飾子の使用をお薦めします。

例外:

IllegalArgumentException - dscがnullである場合。

関連項目:

InputEvent、DragSourceEvent.getLocation()

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int action,
                           int modifiers,
                           int x,
                           int y)

指定されたDragSourceContext、ユーザー・ドロップ・アクション、ターゲット・ドロップ・アクション、修飾子、および座標を使用して、DragSourceDragEventを構築します。

引数dropActionとactionには、1つのアクションを表すDnDConstantsのいずれかを指定するようにしてください。引数modifiersには、古いjava.awt.event.InputEvent.*_MASK定数のビット単位のマスクか、または拡張されたjava.awt.event.InputEvent.*_DOWN_MASK定数のビット単位のマスクのどちらかを指定するようにしてください。このコンストラクタは、無効なdropAction、action、およびmodifiersに対してどの例外もスローしません。

パラメータ:

dsc - このイベントに関連付けられたDragSourceContext。

dropAction - ユーザー・ドロップ・アクション。

action - ターゲット・ドロップ・アクション。

modifiers - イベント発生時に押された修飾キー(Shift、Ctrl、Alt、メタ)。拡張された_DOWN_MASKまたは古い_MASK修飾子のどちらかを使用するべきですが、1つのイベントで両方のモデルを混在させてはいけません。拡張された修飾子の使用をお薦めします。

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

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

例外:

IllegalArgumentException - dscがnullである場合。

導入されたバージョン:

1.4

関連項目:

InputEvent

メソッドの詳細

getTargetActions

public int getTargetActions()

このメソッドは、ターゲット・ドロップ・アクションを返します。

戻り値:

ターゲット・ドロップ・アクション

getGestureModifiers

public int getGestureModifiers()

このメソッドは、ユーザーのジェスチャに関連付けられた入力デバイス修飾子の現在の状態を表すintを返します。通常、これらはマウス・ボタンまたはキーボード修飾子となります。

コンストラクタに渡されたmodifiersが無効である場合、このメソッドはそれを変更せずに返します。

戻り値:

入力デバイス修飾子の現在の状態

getGestureModifiersEx

public int getGestureModifiersEx()

このメソッドは、ユーザーのジェスチャに関連付けられた、拡張された入力デバイス修飾子の現在の状態を表すintを返します。InputEvent.getModifiersEx()を参照してください。

コンストラクタに渡されたmodifiersが無効である場合、このメソッドはそれを変更せずに返します。

戻り値:

入力デバイスの拡張された修飾子の現在の状態

導入されたバージョン:

1.4

getUserAction

public int getUserAction()

このメソッドは、ユーザー・ドロップ・アクションを返します。

戻り値:

ユーザー・ドロップ・アクション

getDropAction

public int getDropAction()

このメソッドは、ターゲット・ドロップ・アクション、およびドラッグ・ソースでサポートされる一連のドロップ・アクションの論理積を返します。

戻り値:

ターゲット・ドロップ・アクション、およびドラッグ・ソースでサポートされる一連のドロップ・アクションの論理積