JavaTM 2 Platform
Standard Ed. 5.0

java.awt.dnd
类 DragSourceEvent

java.lang.Object
  继承者 java.util.EventObject
      继承者 java.awt.dnd.DragSourceEvent
所有已实现的接口:
Serializable
直接已知子类:
DragSourceDragEvent, DragSourceDropEvent

public class DragSourceEvent
extends EventObject

此类是 DragSourceDragEventDragSourceDropEvent 的基类。

只要拖动进入、移动或退出放置点、放置操作改变和拖动结束时就会生成 DragSourceEvent。此事件发生时生成 DragSourceEvent 的位置指定了鼠标光标在屏幕坐标中的位置。

在没有虚拟设备的多屏幕环境中,光标位置是在初始端 GraphicsConfiguration 的坐标系统中指定的。初始端 GraphicsConfiguration 是在其上识别出当前拖动操作的 ComponentGraphicsConfiguration。如果光标的位置位于初始端 GraphicsConfiguration 的边界之外,则对报告的坐标进行截取,使其处于该 GraphicsConfiguration 边界内。

在具有虚拟设备的多屏幕环境中,该位置是在相应的虚拟坐标系统中指定的。如果光标的位置位于虚拟设备的边界之外,则对报告的坐标进行截取,使其处于虚拟设备的边界内。

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

字段摘要
 
从类 java.util.EventObject 继承的字段
source
 
构造方法摘要
DragSourceEvent(DragSourceContext dsc)
          根据一个指定的 DragSourceContext 来构造一个 DragSourceEvent
DragSourceEvent(DragSourceContext dsc, int x, int y)
          构造一个 DragSourceEvent,使其具有指定的 DragSourceContext 和光标位置坐标。
 
方法摘要
 DragSourceContext getDragSourceContext()
          此方法返回引起事件的 DragSourceContext
 Point getLocation()
          此方法返回一个 Point,指示事件发生时光标在屏幕坐标中的位置,如果没有为此事件指定光标位置,则返回 null
 int getX()
          此方法返回事件发生时在屏幕坐标中光标位置的水平坐标,如果没有为此事件指定光标位置,则返回零。
 int getY()
          此方法返回事件发生时在屏幕坐标中光标位置的垂直坐标,如果没有为此事件指定光标位置,则返回零。
 
从类 java.util.EventObject 继承的方法
getSource, toString
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

DragSourceEvent

public DragSourceEvent(DragSourceContext dsc)
根据一个指定的 DragSourceContext 来构造一个 DragSourceEvent。未指定此 DragSourceEvent 的坐标,所以 getLocation 将在此事件中返回 null

参数:
dsc - DragSourceContext
抛出:
IllegalArgumentException - 如果 dscnull
另请参见:
getLocation()

DragSourceEvent

public DragSourceEvent(DragSourceContext dsc,
                       int x,
                       int y)
构造一个 DragSourceEvent,使其具有指定的 DragSourceContext 和光标位置坐标。

参数:
dsc - DragSourceContext
x - 光标位置的水平坐标
y - 光标位置的垂直坐标
抛出:
IllegalArgumentException - 如果 dscnull
从以下版本开始:
1.4
方法详细信息

getDragSourceContext

public DragSourceContext getDragSourceContext()
此方法返回引起事件的 DragSourceContext

返回:
引起事件的 DragSourceContext

getLocation

public Point getLocation()
此方法返回一个 Point,指示事件发生时光标在屏幕坐标中的位置,如果没有为此事件指定光标位置,则返回 null

返回:
指示光标位置的 Point,如果没有指定光标位置,则返回 null
从以下版本开始:
1.4

getX

public int getX()
此方法返回事件发生时在屏幕坐标中光标位置的水平坐标,如果没有为此事件指定光标位置,则返回零。

返回:
一个指示光标位置水平坐标的整数值,如果没有指定光标位置,则返回零
从以下版本开始:
1.4

getY

public int getY()
此方法返回事件发生时在屏幕坐标中光标位置的垂直坐标,如果没有为此事件指定光标位置,则返回零。

返回:
一个指示光标位置垂直坐标的整数值,如果没有指定光标位置,则返回零
从以下版本开始:
1.4

JavaTM 2 Platform
Standard Ed. 5.0

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

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