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