クラスDropTargetDropEvent

java.lang.Object
java.util.EventObject
java.awt.dnd.DropTargetEvent
java.awt.dnd.DropTargetDropEvent
すべての実装されたインタフェース:
Serializable
public class DropTargetDropEvent extends DropTargetEvent
DropTargetDropEventは、DropTargetListenerのdrop()メソッドによって送られます。

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

ソース・ドロップ・アクションは、このドラッグ&ドロップ操作のドラッグ・ソースでサポートされている一連のドロップ・アクションを表すDnDConstantsのビット単位のマスクです。

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

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

  • フィールドのサマリー

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

    context
    修飾子と型
    フィールド
    説明
    protected DropTargetContext
    context
    このDropTargetEventに関連付けられているDropTargetContext。

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

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

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

    コンストラクタ
    コンストラクタ
    説明
    DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
    この操作のDropTargetContext、Componentの座標内のドラッグCursorのホット・スポットの位置、現在選択されているユーザー・ドロップ・アクション、およびソースでサポートされている現在のアクションのセットを使用して、DropTargetDropEventを構築します。
    DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)
    この操作のDropTargetContext、Componentの座標内のドラッグCursorのホット・スポットの位置、現在選択されているユーザー・ドロップ・アクション、ソースでサポートされている現在のアクションのセット、およびソースがターゲットと同じJVM内に存在するかどうかを示すbooleanを使用して、DropTargetEventを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    acceptDrop(int dropAction)
    指定されたアクションを使って、ドロップを受け入れます。
    void
    dropComplete(boolean success)
    このメソッドは、ドロップ転送が完了したことをDragSourceに通知します。
    DataFlavor[]
    getCurrentDataFlavors()
    このメソッドは、現在のDataFlavorを返します。
    List<DataFlavor>
    getCurrentDataFlavorsAsList()
    このメソッドは、現在使用可能なDataFlavorをjava.util.Listとして返します。
    int
    getDropAction()
    このメソッドは、ユーザー・ドロップ・アクションを返します。
    Point
    getLocation()
    このメソッドは、Componentの座標内のCursorの現在の位置を示すPointを返します。
    int
    getSourceActions()
    このメソッドは、ソース・ドロップ・アクションを返します。
    Transferable
    getTransferable()
    このメソッドは、ドロップに関連付けられたTransferableオブジェクトを返します。
    boolean
    isDataFlavorSupported(DataFlavor df)
    このメソッドは、指定されたDataFlavorがソースから使用可能かどうかを示すbooleanを返します。
    boolean
    isLocalTransfer()
    このメソッドは、ソースがターゲットと同じJVMにあるかどうかを示すbooleanを返します。
    void
    rejectDrop()
    ドロップを拒否します。

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

    getDropTargetContext
    修飾子と型
    メソッド
    説明
    DropTargetContext
    getDropTargetContext()
    このメソッドは、このDropTargetEventに関連付けられたDropTargetContextを返します。

    クラスで宣言されたメソッド 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であるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • DropTargetDropEvent

      public DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
      この操作のDropTargetContext、Componentの座標内のドラッグCursorのホット・スポットの位置、現在選択されているユーザー・ドロップ・アクション、およびソースでサポートされている現在のアクションのセットを使用して、DropTargetDropEventを構築します。 デフォルトでは、このコンストラクタはターゲットがソースと同じ仮想マシン内にないことを前提にしています。つまり、isLocalTransfer()はfalseを返します。
      パラメータ:
      dtc - この操作のDropTargetContext
      cursorLocn - Component座標内の「ドラッグ」カーソルのホット・スポットの位置
      dropAction - ユーザー・ドロップ・アクション。
      srcActions - ソース・ドロップ・アクション。
      スロー:
      NullPointerException - cursorLocnが次の場合null
      IllegalArgumentException - dropActionがDnDConstantsのいずれでもない場合。
      IllegalArgumentException - srcActionsがDnDConstantsのビット単位のマスクでない場合。
      IllegalArgumentException - dtcがnullの場合。

    • DropTargetDropEvent

      public DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)
      この操作のDropTargetContext、Componentの座標内のドラッグCursorのホット・スポットの位置、現在選択されているユーザー・ドロップ・アクション、ソースでサポートされている現在のアクションのセット、およびソースがターゲットと同じJVM内に存在するかどうかを示すbooleanを使用して、DropTargetEventを構築します。
      パラメータ:
      dtc - この操作のDropTargetContext
      cursorLocn - Componentの座標内の「ドラッグ」カーソルのホット・スポットの位置
      dropAction - ユーザー・ドロップ・アクション。
      srcActions - ソース・ドロップ・アクション。
      isLocal - ソースがターゲットと同じJVM内にある場合はtrue
      スロー:
      NullPointerException - cursorLocnが次の場合null
      IllegalArgumentException - dropActionがDnDConstantsのいずれでもない場合。
      IllegalArgumentException - srcActionsがDnDConstantsのビット単位のマスクでない場合。
      IllegalArgumentException - dtcがnullの場合。

  • メソッドの詳細

    • getLocation

      public Point getLocation()
      このメソッドは、Componentの座標内のCursorの現在の位置を示すPointを返します。
      戻り値:
      Componentの座標内の現在のCursorの位置。

    • getCurrentDataFlavors

      public DataFlavor[] getCurrentDataFlavors()
      このメソッドは、現在のDataFlavorを返します。
      戻り値:
      現在のDataFlavor

    • getCurrentDataFlavorsAsList

      public List<DataFlavor> getCurrentDataFlavorsAsList()
      このメソッドは、現在使用可能なDataFlavorをjava.util.Listとして返します。
      戻り値:
      現在の有効なDataFlavorのjava.util.List

    • isDataFlavorSupported

      public boolean isDataFlavorSupported(DataFlavor df)
      このメソッドは、指定されたDataFlavorがソースから使用可能かどうかを示すbooleanを返します。
      パラメータ:
      df - テストするDataFlavor
      戻り値:
      指定されたDataFlavorがソースから使用可能な場合はtrue、それ以外の場合はfalse

    • getSourceActions

      public int getSourceActions()
      このメソッドは、ソース・ドロップ・アクションを返します。
      戻り値:
      ソース・ドロップ・アクション

    • getDropAction

      public int getDropAction()
      このメソッドは、ユーザー・ドロップ・アクションを返します。
      戻り値:
      ユーザー・ドロップ・アクション

    • getTransferable

      public Transferable getTransferable()
      このメソッドは、ドロップに関連付けられたTransferableオブジェクトを返します。
      戻り値:
      ドロップに関連付けられたTransferable

    • acceptDrop

      public void acceptDrop(int dropAction)
      指定されたアクションを使って、ドロップを受け入れます。
      パラメータ:
      dropAction - 指定されたアクション

    • rejectDrop

      public void rejectDrop()
      ドロップを拒否します。

    • dropComplete

      public void dropComplete(boolean success)
      このメソッドは、ドロップ転送が完了したことをDragSourceに通知します。
      パラメータ:
      success - ドロップ転送が完了したことを示すboolean。

    • isLocalTransfer

      public boolean isLocalTransfer()
      このメソッドは、ソースがターゲットと同じJVMにあるかどうかを示すbooleanを返します。
      戻り値:
      ソースが同じJVMにある場合はtrue、それ以外の場合はfalse