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

Class DropTargetDragEvent

  • 实现的所有接口
    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如果这个放置动作不被拖动源所支持。

    如果用户没有选择降动作,一套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用于此操作, Component的坐标中的“拖动” Cursor的热点位置,用户放置操作和源放置操作。
        参数
        dtc - 此操作的DropTargetContext
        cursorLocn - “组件”坐标中“拖动”光标的热点的位置
        dropAction - 用户放弃操作
        srcActions - 源丢弃操作
        异常
        NullPointerException - 如果cursorLocn为null
        IllegalArgumentException - 如果dropAction不是 DnDConstants
        IllegalArgumentException -如果srcActions不是位掩码 DnDConstants
        IllegalArgumentException - 如果dtc是 null
    • 方法详细信息

      • getLocation

        public Point getLocation()
        此方法返回 Point指示 CursorComponent'坐标系内的当前位置。
        结果
        当前光标位置在 Component的坐标上。
      • getCurrentDataFlavors

        public DataFlavor[] getCurrentDataFlavors()
        该方法返回当前 DataFlavor从S DropTargetContext
        结果
        DropTargetContext中的当前DataFlavor
      • getCurrentDataFlavorsAsList

        public List<DataFlavor> getCurrentDataFlavorsAsList()
        此方法将当前 DataFlavor s作为 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)
        接受阻力。 如果实现希望接受来自srcActions的操作而不是用户选择的操作(如dropAction所表示), dragOverDropTargetListeners dragEnterdropActionChanged方法调用此方法。
        参数
        dragOperation - 目标接受的操作
      • rejectDrag

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