模块 java.desktop
包 java.awt.dnd

类 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
参见：

  • 构造方法详细信息

    • DropTargetDropEvent

      public DropTargetDropEvent(DropTargetContext  dtc, Point  cursorLocn, int dropAction, int srcActions)
      给定此操作的 DropTargetContext、拖动 Cursor 的热点在 Component 的坐标中的位置、当前选择的用户放置操作以及源支持的当前操作集，构造一个 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、拖动 Cursor 的热点在 Component 的坐标中的位置、当前选择的用户放置操作、源支持的当前操作集以及指示源是否存在的 boolean 构造一个 DropTargetEvent与目标位于同一 JVM 中。
      参数：
      dtc - 此操作的 DropTargetContext
      cursorLocn - “拖动”光标在组件坐标中的热点位置
      dropAction - 用户放下操作。
      srcActions - 源丢弃操作。
      isLocal - 如果源与目标位于同一 JVM 中则为真
      抛出：
      NullPointerException - 如果 cursorLocn 是 null
      IllegalArgumentException - 如果 dropAction 不是 DnDConstants 之一。
      IllegalArgumentException - 如果 srcActions 不是 DnDConstants 的按位掩码。
      IllegalArgumentException - 如果 dtc 是 null。

  • 方法详情

    • getLocation

      public Point  getLocation()
      此方法返回一个 Point，指示 Cursor 在 Component 的坐标中的当前位置。
      返回：
      组件坐标中的当前 Cursor 位置。

    • getCurrentDataFlavors

      public DataFlavor [] getCurrentDataFlavors()
      此方法返回当前的 DataFlavors。
      返回：
      当前数据类型

    • getCurrentDataFlavorsAsList

      public List <DataFlavor > getCurrentDataFlavorsAsList()
      此方法将当前可用的 DataFlavor s 作为 java.util.List 返回。
      返回：
      当前可用的 DataFlavors 作为 java.util.List

    • isDataFlavorSupported

      public boolean isDataFlavorSupported(DataFlavor  df)
      此方法返回一个 boolean 指示指定的 DataFlavor 是否可从源中获得。
      参数：
      df - 要测试的 DataFlavor
      返回：
      如果指定的 DataFlavor 可从源中获得

    • getSourceActions

      public int getSourceActions()
      此方法返回源放置操作。
      返回：
      源丢弃操作。

    • getDropAction

      public int getDropAction()
      此方法返回用户放下操作。
      返回：
      用户放下动作。

    • getTransferable

      public Transferable  getTransferable()
      此方法返回与 drop 关联的 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()
      此方法返回一个 int 指示源是否与目标位于同一 JVM 中。
      返回：
      如果 Source 在同一个 JVM 中