- すべての実装されたインタフェース:
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
-
コンストラクタの詳細
-
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()このメソッドは、ターゲット・ドロップ・アクション、およびドラッグ・ソースでサポートされる一連のドロップ・アクションの論理積を返します。- 戻り値:
- ターゲット・ドロップ・アクション、およびドラッグ・ソースでサポートされる一連のドロップ・アクションの論理積
-