DropTargetDragEvent

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

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

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

java.awt.dnd
类 DropTargetDragEvent

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

所有已实现的接口：: Serializable

public class DropTargetDragEvent
extends DropTargetEvent

通过 dragEnter() 和 dragOver() 方法将 DropTargetDragEvent 发送给 DropTargetListener。

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

源 drop 操作 是 DnDConstants 的位掩码，DnDConstants 表示受此 drag 操作的 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`

构造方法摘要
`DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)` 在给出此操作的 `DropTargetContext`、`Component` 坐标中 "Drag" `Cursor` 热点的位置、用户 drop 操作和源 drop 操作的情况下，构造一个 `DropTargetDragEvent`。

方法摘要
`void`	`acceptDrag(int dragOperation)` 接受 drag。
`DataFlavor[]`	`getCurrentDataFlavors()` 此方法返回来自 `DropTargetContext` 的当前 `DataFlavor`。
`List<DataFlavor>`	`getCurrentDataFlavorsAsList()` 此方法以 `java.util.List` 形式返回当前的 `DataFlavor`
`int`	`getDropAction()` 此方法返回用户 drop 操作。
`Point`	`getLocation()` 此方法返回一个指示 `Component` 坐标中 `Cursor` 当前位置的 `Point`。
`int`	`getSourceActions()` 此方法返回源 drop 操作。
`Transferable`	`getTransferable()` 此方法返回 Transferable 对象，该对象表示与当前的 drag 操作有关的数据。
`boolean`	`isDataFlavorSupported(DataFlavor df)` 此方法返回一个指示指定的 `DataFlavor` 是否受支持 `boolean` 值。
`void`	`rejectDrag()` 作为检查 `dropAction` 或可用的 `DataFlavor` 类型的结果，拒绝 drag。

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

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

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

构造方法详细信息

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

在给出此操作的 DropTargetContext、Component 坐标中 "Drag" Cursor 热点的位置、用户 drop 操作和源 drop 操作的情况下，构造一个 DropTargetDragEvent。

参数：: dtc - 此操作的 DropTargetContext; cursorLocn - Component 坐标中 "Drag" Cursor 热点的位置; dropAction - 用户 drop 操作; srcActions - 源 drop 操作

抛出：

NullPointerException - 如果 cursorLocn 为 null

IllegalArgumentException - 如果 dropAction 不是 DnDConstants 之一。

IllegalArgumentException - 如果 srcAction 不是 DnDConstants 的位掩码。

IllegalArgumentException - 如果 dtc 为 null。

方法详细信息

getLocation

public Point getLocation()

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

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

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

此方法返回来自 DropTargetContext 的当前 DataFlavor。

返回：: 来自 DropTargetContext 的当前 DataFlavor

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

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

返回：: 当前 DataFlavor 的 java.util.List

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

此方法返回一个指示指定的 DataFlavor 是否受支持 boolean 值。

参数：: df - 要测试的 DataFlavor
返回：: 特定 DataFlavor 是否受支持

getSourceActions

public int getSourceActions()

此方法返回源 drop 操作。

返回：: 源 drop 操作

getDropAction

public int getDropAction()

此方法返回用户 drop 操作。

返回：: 用户 drop 操作

getTransferable

public Transferable getTransferable()

此方法返回 Transferable 对象，该对象表示与当前的 drag 操作有关的数据。

返回：: 与 drag 操作有关的 Transferable
抛出：: InvalidDnDOperationException - 如果与 drag 操作有关的数据不可用
从以下版本开始：: 1.5

acceptDrag

public void acceptDrag(int dragOperation)

接受 drag。如果实现希望接受来自 srcAction 的操作，而不是接受用户选择的操作（表示为 dropAction），则应该从 DropTargetListener、dragEnter、dragOver 和 dropActionChanged 方法来调用此方法。

参数：: dragOperation - 目标所接受的操作

rejectDrag

public void rejectDrag()

作为检查 dropAction 或可用的 DataFlavor 类型的结果，拒绝 drag。

概述