java.awt.dnd
类 DragSourceDropEvent

java.lang.Object
  java.util.EventObject
      java.awt.dnd.DragSourceEvent
          java.awt.dnd.DragSourceDropEvent

所有已实现的接口：

Serializable

public class DragSourceDropEvent
extends DragSourceEvent

通过 DragSourceContext，将 DragSourceDropEvent 从 DragSourceContextPeer 传递给向 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener 的 dragDropEnd 方法。它包含足够的信息，允许操作的发起方在操作完成时向最终用户提供适当的反馈。

从以下版本开始：

1.2

另请参见：

序列化表格

字段摘要

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

source

构造方法摘要

DragSourceDropEvent(DragSourceContext dsc)
针对没有引起放置的拖动构造一个 DragSourceDropEvent。

DragSourceDropEvent(DragSourceContext dsc, int action, boolean success)
放置构造一个具有给定 DragSourceContext、放置操作和指示放置是否成功的 boolean 值的 DragSourceDropEvent。

DragSourceDropEvent(DragSourceContext dsc, int action, boolean success, int x, int y)
针对放置构造一个具有给定 DragSourceContext、放置操作、表示放置是否成功的 boolean 值和坐标的 DragSourceDropEvent。

方法摘要

int	getDropAction() 此方法返回一个 int 值，表示放置主题目标执行的操作。
boolean	getDropSuccess() 此方法返回表示放置是否成功的 boolean 值。

从类 java.awt.dnd.DragSourceEvent 继承的方法

getDragSourceContext, getLocation, getX, getY

从类 java.util.EventObject 继承的方法

getSource, toString

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

DragSourceDropEvent

public DragSourceDropEvent(DragSourceContext dsc,
                           int action,
                           boolean success)

放置构造一个具有给定 DragSourceContext、放置操作和指示放置是否成功的 boolean 值的 DragSourceDropEvent。未指定此 DragSourceDropEvent 的坐标，所以 getLocation 将在此事件中返回 null。

参数 action 应该是表示单个操作的 DnDConstants 之一。对于无效的 action，此构造方法不抛出任何异常。

参数：

dsc - 与此 DragSourceDropEvent 关联的 DragSourceContext

action - 放置操作

success - 指示放置是否成功的 boolean 值

抛出：

IllegalArgumentException - 如果 dsc 为 null。

另请参见：

DragSourceEvent.getLocation()

DragSourceDropEvent

public DragSourceDropEvent(DragSourceContext dsc,
                           int action,
                           boolean success,
                           int x,
                           int y)

针对放置构造一个具有给定 DragSourceContext、放置操作、表示放置是否成功的 boolean 值和坐标的 DragSourceDropEvent。

参数 action 应该是表示单个操作的 DnDConstants 之一。对于无效的 action，此构造方法不抛出任何异常。

参数：

dsc - 与此 DragSourceDropEvent 关联的 DragSourceContext

action - 放置操作

success - 表示放置是否成功的 boolean 值

x - 光标位置的水平坐标

y - 光标位置的垂直坐标

抛出：

IllegalArgumentException - 如果 dsc 为 null。

从以下版本开始：

1.4

DragSourceDropEvent

public DragSourceDropEvent(DragSourceContext dsc)

针对没有引起放置的拖动构造一个 DragSourceDropEvent。未指定此 DragSourceDropEvent 的坐标，所以 getLocation 将为此事件返回 null。

参数：

dsc - DragSourceContext

抛出：

IllegalArgumentException - 如果 dsc 为 null。

另请参见：

DragSourceEvent.getLocation()

方法详细信息

getDropSuccess

public boolean getDropSuccess()

此方法返回表示放置是否成功的 boolean 值。

返回：

如果放置目标接受了该放置并且成功地执行了放置操作，则返回 true；如果放置目标拒绝该放置或者放置目标接受了该放置，但是无法执行放置操作，则返回 false。

getDropAction

public int getDropAction()

此方法返回一个 int 值，表示放置主题目标执行的操作。

返回：

如果放置目标接受了该放置并且拖动源支持目标放置操作，则返回放置主题目标执行的操作；否则返回 DnDConstants.ACTION_NONE。