Module  java.desktop
软件包  java.awt.dnd

Class DropTargetDropEvent

  • All Implemented Interfaces:
    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 。

    如果用户没有选drop操作，一组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坐标中“拖动”光标的热点 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真
        异常
        NullPointerException - 如果cursorLocn是 null
        IllegalArgumentException - 如果dropAction不是 DnDConstants 。
        IllegalArgumentException -如果srcActions不是位掩码 DnDConstants 。
        IllegalArgumentException - 如果dtc是 null 。

    • 方法详细信息

      • getLocation

        public Point getLocation​()
        该方法返回一个 Point指示 Cursor “在当前位置 Component坐标”。
        结果
        当前的 Cursor位置在组件的 Cursor 。

      • getCurrentDataFlavors

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

      • getCurrentDataFlavorsAsList

        public List<DataFlavor> getCurrentDataFlavorsAsList​()
        该方法返回当前可用的 DataFlavor作为 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​()
        此方法返回与该下拉关联的 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指示源是否与目标相同。
        结果
        如果Source在同一个JVM中