java.awt.dnd
类 DropTargetDragEvent

java.lang.Object
  java.util.EventObject
      java.awt.dnd.DropTargetEvent
          java.awt.dnd.DropTargetDragEvent

所有已实现的接口：

Serializable

public class DropTargetDragEvent
     

      extends 
      DropTargetEvent
     

通过 dragEnter() 和 dragOver() 方法将 DropTargetDragEvent 发送给 DropTargetListener。

DropTargetDragEvent 报告源 drop 操作 和用户 drop 操作，这些操作反映了 drag 操作的当前状态。

源 drop 操作 是 DnDConstants 的位掩码，DnDConstants 表示受此 drag 操作的 drag 源支持的 drop 操作集合。

用户 drop 操作 取决于受 drag 源支持的 drop 操作和用户选定的 drop 操作。在进行 drag 操作中，用户可以通过按下修正键选择一个 drop 操作。

 
   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE

如果用户没有选 drop 操作，则表示受 drag 源支持的 drop 操作集合的 DnDConstants 集合是先搜索 DnDConstants.ACTION_MOVE，然后搜索 DnDConstants.ACTION_COPY，最后搜索 DnDConstants.ACTION_LINK 而得到的，并且用户 drop 操作 是找到的第一个常量。如果找不到常量，则用户 drop 操作 为 DnDConstants.ACTION_NONE。

从以下版本开始：

1.2

另请参见：

序列化表格

DropTargetDragEvent

public DropTargetDragEvent(DropTargetContext dtc,
                           Point cursorLocn,
                           int dropAction,
                           int srcActions)

在给出此操作的 DropTargetContext、 Component 坐标中 "Drag" Cursor 热点的位置、用户 drop 操作和源 drop 操作的情况下，构造一个 DropTargetDragEvent。

参数：

dtc - 此操作的 DropTargetContext

cursorLocn - Component 坐标中 "Drag" Cursor 热点的位置

dropAction - 用户 drop 操作

srcActions - 源 drop 操作

抛出：

NullPointerException - 如果 cursorLocn 为 null

IllegalArgumentException - 如果 dropAction 不是 DnDConstants 之一。

IllegalArgumentException - 如果 srcAction 不是 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()

此方法以 java.util.List 形式返回当前的 DataFlavor

返回：

当前 DataFlavor 的 java.util.List

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

此方法返回一个指示指定的 DataFlavor 是否受支持 boolean 值。

参数：

df - 要测试的 DataFlavor

返回：

特定 DataFlavor 是否受支持

getSourceActions

public int getSourceActions()

此方法返回源 drop 操作。

返回：

源 drop 操作

getDropAction

public int getDropAction()

此方法返回用户 drop 操作。

返回：

用户 drop 操作

getTransferable

public Transferable getTransferable()

此方法返回 Transferable 对象，该对象表示与当前的 drag 操作有关的数据。

返回：

与 drag 操作有关的 Transferable

抛出：

InvalidDnDOperationException - 如果与 drag 操作有关的数据不可用

从以下版本开始：

1.5

acceptDrag

public void acceptDrag(int dragOperation)

接受 drag。如果实现希望接受来自 srcAction 的操作，而不是接受用户选择的操作（表示为 dropAction），则应该从 DropTargetListener、 dragEnter、 dragOver 和 dropActionChanged 方法来调用此方法。

参数：

dragOperation - 目标所接受的操作

rejectDrag

public void rejectDrag()

作为检查 dropAction 或可用的 DataFlavor 类型的结果，拒绝 drag。