モジュール java.desktop
パッケージ java.awt.dnd

クラスDropTargetDragEvent

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

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

ソース・ドロップ・アクションは、このドラッグ操作のドラッグ・ソースでサポートされている一連のドロップ・アクションを表す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
関連項目:
直列化された形式

  • フィールドのサマリー

    クラス java.awt.dnd.DropTargetEventで宣言されたフィールド

    context

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

    source

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

    コンストラクタ
    コンストラクタ 説明
    DropTargetDragEvent​(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
    この操作のDropTargetContext、Componentの座標内の「ドラッグ」Cursorのホット・スポットの位置、ユーザー・ドロップ・アクション、およびソース・ドロップ・アクションを使用して、DropTargetDragEventを構築します。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    void acceptDrag​(int dragOperation)
    ドラッグを受け入れます。
    DataFlavor[] getCurrentDataFlavors()
    このメソッドは、DropTargetContextから現在の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を返します。
    void rejectDrag()
    dropActionまたは使用可能なDataFlavorのタイプのどちらかを検査した結果としてドラッグを拒否します。

    クラス java.awt.dnd.DropTargetEventで宣言されたメソッド

    getDropTargetContext

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

    getSource, toString

    クラス java.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • コンストラクタの詳細

    • DropTargetDragEvent

      public DropTargetDragEvent​(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
      この操作のDropTargetContext、Componentの座標内の「ドラッグ」Cursorのホット・スポットの位置、ユーザー・ドロップ・アクション、およびソース・ドロップ・アクションを使用して、DropTargetDragEventを構築します。
      パラメータ:
      dtc - この操作のDropTargetContext
      cursorLocn - Component座標内の「ドラッグ」カーソルのホット・スポットの位置
      dropAction - ユーザー・ドロップ・アクション
      srcActions - ソース・ドロップ・アクション
      例外:
      NullPointerException - cursorLocnがnullの場合
      IllegalArgumentException - dropActionがDnDConstantsのいずれでもない場合。
      IllegalArgumentException - srcActionsがDnDConstantsのビット単位のマスクでない場合。
      IllegalArgumentException - dtcがnullの場合。

  • メソッドの詳細

    • getLocation

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

    • getCurrentDataFlavors

      public DataFlavor[] getCurrentDataFlavors()
      このメソッドは、DropTargetContextから現在のDataFlavorを返します。
      戻り値:
      DropTargetContextからの現在の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がサポートされているかどうか

    • getSourceActions

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

    • getDropAction

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

    • getTransferable

      public Transferable getTransferable()
      このメソッドは、現在のドラッグ操作に関連したデータを表すTransferableオブジェクトを返します。
      戻り値:
      ドラッグ操作に関連するTransferable
      例外:
      InvalidDnDOperationException - ドラッグ操作に関連付けられたデータが使用できない場合
      導入されたバージョン:
      1.5

    • acceptDrag

      public void acceptDrag​(int dragOperation)
      ドラッグを受け入れます。 このメソッドは、実装でsrcActionsからdropActionで表された、ユーザーによって選択された操作以外の操作を受け入れるようにしたい場合に、DropTargetListenersのdragEnter、dragOver、およびdropActionChangedメソッドから呼び出すようにしてください。
      パラメータ:
      dragOperation - ターゲットによって受け入れられる操作

    • rejectDrag

      public void rejectDrag()
      dropActionまたは使用可能なDataFlavorのタイプのどちらかを検査した結果としてドラッグを拒否します。