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

Class DropTargetDragEvent

  • All Implemented Interfaces:
    Serializable 

    public class DropTargetDragEvent
extends DropTargetEvent
    所述DropTargetDragEvent被输送到DropTargetListener经由其dragEnter事件（）和的dragover（）方法。

    DropTargetDragEvent报告源放置操作和反映拖动操作的当前状态的用户放置操作。

    源放置操作是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

    • 构造方法详细信息

      • DropTargetDragEvent

        public DropTargetDragEvent​(DropTargetContext dtc,
                           Point cursorLocn,
                           int dropAction,
                           int srcActions)
        构造一个 DropTargetDragEvent给出的 DropTargetContext此操作中，“拖”的位置 Cursor “在S热点 Component坐标”，用户放置动作，和源drop操作。
        参数
        dtc - 此操作的DropTargetContext
        cursorLocn - 组件坐标中“拖动”光标的热点的位置
        dropAction - 用户放弃操作
        srcActions - 源丢弃操作
        异常
        NullPointerException - 如果cursorLocn为空
        IllegalArgumentException - 如果dropAction不是 DnDConstants 。
        IllegalArgumentException -如果srcActions不是位掩码 DnDConstants 。
        IllegalArgumentException - 如果dtc是 null 。

    • 方法详细信息

      • getLocation

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

      • getCurrentDataFlavors

        public DataFlavor[] getCurrentDataFlavors​()
        此方法从 DropTargetContext返回当前的 DataFlavor s。
        结果
        来自DropTargetContext的当前DataFlavors

      • getCurrentDataFlavorsAsList

        public List<DataFlavor> getCurrentDataFlavorsAsList​()
        此方法返回当前的 DataFlavor作为 java.util.List
        结果
        一个 java.util.List的当前 DataFlavor s

      • 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
        异常
        InvalidDnDOperationException - 如果与拖动操作相关联的数据不可用
        从以下版本开始：
        1.5

      • acceptDrag

        public void acceptDrag​(int dragOperation)
        接受拖动 此方法应来自被称为DropTargetListeners dragEnter ， dragOver和dropActionChanged方法如果实现希望接受从比由用户选择如由表示的一个其它srcActions操作dropAction 。
        参数
        dragOperation - 目标接受的操作

      • rejectDrag

        public void rejectDrag​()
        Rejects the drag as a result of examining either the dropAction or the available DataFlavor types.