クラス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
関連項目:

  • フィールドのサマリー

    クラスで宣言されたフィールド EventObject

    source
    修飾子と型
    フィールド
    説明
    protected Object
    source
    Eventが最初に発生したオブジェクト。

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

    コンストラクタ
    コンストラクタ
    説明
    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()
    このメソッドは、ユーザー・ドロップ・アクションを返します。

    クラスで宣言されたメソッド DragSourceEvent

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

    クラスで宣言されたメソッド EventObject

    getSource, toString
    修飾子と型
    メソッド
    説明
    Object
    getSource()
    Eventが最初に発生したオブジェクト。
    String
    toString()
    このEventObjectのString表現を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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である場合。
      関連項目:

    • 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
      関連項目:

  • メソッドの詳細

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