モジュール java.desktop
パッケージ 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
    関連項目:
    直列化された形式

    • フィールドのサマリー

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

      コンストラクタ 
      コンストラクタ 説明
      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を構築します。

    • コンストラクタの詳細

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