java.awt.dnd
类 DropTargetDropEvent

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

所有已实现的接口：

Serializable

public class DropTargetDropEvent
     

      extends 
      DropTargetEvent
     

通过 DropTargetListener drop() 方法发送 DropTargetDropEvent。

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

源 drop 操作 是 DnDConstants 的位掩码，DnDConstants 表示受 drag-and-drop 操作的 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

另请参见：

序列化表格

DropTargetDropEvent

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

在给出此操作的 DropTargetContext、 Component 坐标中 drag Cursor 的热点位置、目前选择的用户 drop 操作和当前受源对象支持的操作集合的情况下，构造一个 DropTargetDropEvent。默认情况下，此构造器假定目标对象与源对象不在同一虚拟机中；也就是说， isLocalTransfer() 将返回 false。

参数：

dtc - 此操作的 DropTargetContext

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

dropAction - 用户 drop 操作。

srcActions - 源 drop 操作。

抛出：

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 的坐标中 drag Cursor 的热点位置、目前选择的用户 drop 操作、当前受源对象支持的操作集合，以及一个指示源对象与目标对象是否在同一 JVM 中的 boolean 值的情况下，构造一个 DropTargetEvent。

参数：

dtc - 此操作的 DropTargetContext

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

dropAction - 用户 drop 操作。

srcActions - 源 drop 操作。

isLocal - 如果源对象与目标对象在同一 JVM 中，则为 true

抛出：

NullPointerException - 如果 cursorLocn 为 null

IllegalArgumentException - 如果 dropAction 不是 DnDConstants 之一。

IllegalArgumentException - 如果 srcAction 不是 DnDConstants 的位掩码。

IllegalArgumentException - 如果 dtc 为 null。

getLocation

public Point getLocation()

此方法返回一个 Point，指示 Component 坐标中 Cursor 的当前位置。

返回：

Component 坐标中 Cursor 的当前位置。

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

此方法返回当前的 DataFlavor。

返回：

当前的 DataFlavor

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

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

返回：

java.util.List 形式的当前可用 DataFlavor

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()

此方法返回与 drop 相关的 Transferable 对象。

返回：

与 drop 相关的 Transferable

acceptDrop

public void acceptDrop(int dropAction)

使用指定的操作接受 drop。

参数：

dropAction - 指定的操作

rejectDrop

public void rejectDrop()

拒绝 Drop。

dropComplete

public void dropComplete(boolean success)

此方法通知 DragSource drop 传输已完成。

参数：

success - 指示 drop 传输已完成的 boolean 值。

isLocalTransfer

public boolean isLocalTransfer()

此方法返回一个指示源对象与目标对象是否在同一 JVM 中的 int。

返回：

Source 是否在同一 JVM 中