Java java.awt.dnd 类 DropTargetDropEvent（JDK5）

229 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt.dnd
类 DropTargetDropEvent

java.lang.Object
  java.util.EventObject
      java.awt.dnd.DropTargetEvent
          java.awt.dnd.DropTargetDropEvent

所有已实现的接口：: Serializable

public class DropTargetDropEvent
extends DropTargetEvent
extends DropTargetEvent

通过 DropTargetListener drop() 方法发送 DropTargetDropEvent。

DropTargetDropEvent 报告源 drop 操作 和用户 drop 操作，这些操作反映了 drag-and-drop 操作的当前状态。

源 drop 操作 是 DnDConstants 的位掩码，DnDConstants 表示受 drag-and-drop 操作的 drag 源支持的 drop 操作集合。

用户 drop 操作 取决于受 drag 源支持的 drop 操作和用户选定的 drop 操作。在进行 drag 操作中，用户可以通过按下修正键选择一个 drop 操作。

 
   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE

当用户选择一个 drop 操作时，如果此 drop 操作受 drag 源支持，则用户 drop 操作 为 DnDConstants 之一，如果此 drop 操作不受 drag 源支持，则用户 drop 操作为 DnDConstants.ACTION_NONE 之一。

如果用户没有选 drop 操作，则表示受 drag 源支持的 drop 操作集合的 DnDConstants 集合是先搜索 DnDConstants.ACTION_MOVE，然后搜索 DnDConstants.ACTION_COPY，最后搜索 DnDConstants.ACTION_LINK 而得到的，并且用户 drop 操作 是找到的第一个常量。如果找不到常量，则用户 drop 操作 为 DnDConstants.ACTION_NONE。

从以下版本开始：: 1.2
另请参见：: 序列化表格

字段摘要

从类 java.awt.dnd.DropTargetEvent 继承的字段
`context`

从类 java.util.EventObject 继承的字段
`source`

构造方法摘要
`DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)` 在给出此操作的 `DropTargetContext`、`Component` 坐标中 drag `Cursor` 的热点位置、目前选择的用户 drop 操作和当前受源对象支持的操作集合的情况下，构造一个 `DropTargetDropEvent`。
`DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)` 在给出此操作的 `DropTargetContext`、`Component` 的坐标中 drag `Cursor` 的热点位置、目前选择的用户 drop 操作、当前受源对象支持的操作集合，以及一个指示源对象与目标对象是否在同一 JVM 中的 `boolean` 值的情况下，构造一个 `DropTargetEvent`。

构造方法摘要

DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
在给出此操作的 DropTargetContext、Component 坐标中 drag Cursor 的热点位置、目前选择的用户 drop 操作和当前受源对象支持的操作集合的情况下，构造一个 DropTargetDropEvent。

DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)
在给出此操作的 DropTargetContext、Component 的坐标中 drag Cursor 的热点位置、目前选择的用户 drop 操作、当前受源对象支持的操作集合，以及一个指示源对象与目标对象是否在同一 JVM 中的 boolean 值的情况下，构造一个 DropTargetEvent。

方法摘要
`void`	`acceptDrop(int dropAction)` 使用指定的操作接受 drop。
`void`	`dropComplete(boolean success)` 此方法通知 `DragSource` drop 传输已完成。
`DataFlavor[]`	`getCurrentDataFlavors()` 此方法返回当前的 DataFlavor。
`List<DataFlavor>`	`getCurrentDataFlavorsAsList()` 此方法以 `java.util.List` 形式返回当前可用的 `DataFlavor`。
`int`	`getDropAction()` 此方法返回用户 drop 操作。
`Point`	`getLocation()` 此方法返回一个 `Point`，指示 `Component` 坐标中 `Cursor` 的当前位置。
`int`	`getSourceActions()` 此方法返回源 drop 操作。
`Transferable`	`getTransferable()` 此方法返回与 drop 相关的 `Transferable` 对象。
`boolean`	`isDataFlavorSupported(DataFlavor df)` 此方法返回一个 `boolean` 值，指示指定的 `DataFlavor` 是否可在源对象中使用。
`boolean`	`isLocalTransfer()` 此方法返回一个 `int`，指示源对象与目标对象是否在同一 JVM 中。
`void`	`rejectDrop()` 拒绝 Drop。

从类 java.awt.dnd.DropTargetEvent 继承的方法
`getDropTargetContext`

从类 java.util.EventObject 继承的方法
`getSource, toString`

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

构造方法详细信息

DropTargetDropEvent

public DropTargetDropEvent(DropTargetContext dtc,
                           Point cursorLocn,
                           int dropAction,
                           int srcActions)

在给出此操作的 DropTargetContext、Component 坐标中 drag Cursor 的热点位置、目前选择的用户 drop 操作和当前受源对象支持的操作集合的情况下，构造一个 DropTargetDropEvent。默认情况下，此构造器假定目标对象与源对象不在同一虚拟机中；也就是说，isLocalTransfer() 将返回 false。

参数：: dtc - 此操作的 DropTargetContext; cursorLocn - Component 坐标中 "Drag" Cursor 的热点位置; dropAction - 用户 drop 操作。; srcActions - 源 drop 操作。
抛出：: 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、Component 的坐标中 drag Cursor 的热点位置、目前选择的用户 drop 操作、当前受源对象支持的操作集合，以及一个指示源对象与目标对象是否在同一 JVM 中的 boolean 值的情况下，构造一个 DropTargetEvent。

参数：: dtc - 此操作的 DropTargetContext; cursorLocn - Component 坐标中 "Drag" Cursor 的热点位置; dropAction - 用户 drop 操作。; srcActions - 源 drop 操作。; isLocal - 如果源对象与目标对象在同一 JVM 中，则为 true
抛出：: NullPointerException - 如果 cursorLocn 为 null; IllegalArgumentException - 如果 dropAction 不是 DnDConstants 之一。; IllegalArgumentException - 如果 srcAction 不是 DnDConstants 的位掩码。; IllegalArgumentException - 如果 dtc 为 null。

方法详细信息

getLocation

public Point getLocation()

此方法返回一个 Point，指示 Component 坐标中 Cursor 的当前位置。

返回：: Component 坐标中 Cursor 的当前位置。

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

此方法返回当前的 DataFlavor。

返回：: 当前的 DataFlavor

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

此方法以 java.util.List 形式返回当前可用的 DataFlavor。

返回：: java.util.List 形式的当前可用 DataFlavor

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

此方法返回一个 boolean 值，指示指定的 DataFlavor 是否可在源对象中使用。

参数：: df - 要测试的 DataFlavor
返回：: 是否指定的 DataFlavor 是否可在源对象中使用

getSourceActions

public int getSourceActions()

此方法返回源 drop 操作。

返回：: 源 drop 操作。

getDropAction

public int getDropAction()

此方法返回用户 drop 操作。

返回：: 用户 drop 操作。