模块  java.desktop
软件包  java.awt.dnd

Class 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和用户drop操作是找到的第一个常量。 如果未找到常量，则用户删除操作为DnDConstants.ACTION_NONE 。

    从以下版本开始：
    1.2
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • DropTargetDropEvent

        public DropTargetDropEvent​(DropTargetContext dtc,
                           Point cursorLocn,
                           int dropAction,
                           int srcActions)
        构造DropTargetDropEvent给定DropTargetContext用于此操作， Cursor的热点在Component的坐标中的位置，当前选定的用户放置操作以及源支持的当前操作集。 默认情况下，此构造函数假定目标与源不在同一个虚拟机中; 也就是说， 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)
        构造 DropTargetEvent给定 DropTargetContext用于此操作， Cursor的热点位于 Component的坐标位置，当前选定的用户放置操作，源支持的当前操作集，以及指示源是否为 boolean与目标位于同一JVM中。
        参数
        dtc - 此操作的DropTargetContext
        cursorLocn - “组件”坐标中“拖动”光标的热点的位置
        dropAction - 用户放置操作。
        srcActions - 源放置操作。
        isLocal - 如果源与目标位于同一JVM中， isLocal True
        异常
        NullPointerException - 如果cursorLocn是 null
        IllegalArgumentException - 如果dropAction不是 DnDConstants 。
        IllegalArgumentException -如果srcActions不是位掩码 DnDConstants 。
        IllegalArgumentException - 如果dtc是 null 。

    • 方法详细信息

      • getLocation

        public Point getLocation()
        此方法返回 Point指示 Cursor在 Component坐标中的当前位置。
        结果
        当前 Cursor位于Component的坐标中。

      • getCurrentDataFlavors

        public DataFlavor[] getCurrentDataFlavors()
        此方法返回当前的DataFlavors。
        结果
        当前的DataFlavors

      • getCurrentDataFlavorsAsList

        public List<DataFlavor> getCurrentDataFlavorsAsList()
        此方法将当前可用的 DataFlavor作为 java.util.List 。
        结果
        当前可用的DataFlavor作为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()
        此方法返回与 Transferable关联的 Transferable对象。
        结果
        与 Transferable有关的 Transferable

      • acceptDrop

        public void acceptDrop​(int dropAction)
        使用指定的操作接受放置。
        参数
        dropAction - 指定的操作

      • rejectDrop

        public void rejectDrop()
        拒绝Drop。

      • dropComplete

        public void dropComplete​(boolean success)
        此方法通知 DragSource已完成丢弃传输。
        参数
        success - boolean表示已完成拖放传输。

      • isLocalTransfer

        public boolean isLocalTransfer()
        此方法返回 int指示源是否与目标位于同一JVM中。
        结果
        如果Source在同一个JVM中