JavaTM 2 Platform
Standard Ed. 5.0

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,将 DragSourceDropEventDragSourceContextPeer 传递给向 DragSourceContext 及其关联 DragSource 注册的 DragSourceListenerdragDropEnd 方法。它包含足够的信息,允许操作的发起方在操作完成时向最终用户提供适当的反馈。

从以下版本开始:
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 - 如果 dscnull
另请参见:
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 - 如果 dscnull
从以下版本开始:
1.4

DragSourceDropEvent

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

参数:
dsc - DragSourceContext
抛出:
IllegalArgumentException - 如果 dscnull
另请参见:
DragSourceEvent.getLocation()
方法详细信息

getDropSuccess

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

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

getDropAction

public int getDropAction()
此方法返回一个 int 值,表示放置主题目标执行的操作。

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

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策