JavaTM 2 Platform
Standard Ed. 5.0

java.awt.dnd
类 DragGestureEvent

java.lang.Object
  继承者 java.util.EventObject
      继承者 java.awt.dnd.DragGestureEvent
所有已实现的接口:
Serializable

public class DragGestureEvent
extends EventObject

当特定的 DragGestureRecognizer 检测到它正在跟踪的 Component 上已发生与平台相关的拖动启动动作时,将 DragGestureEvent 传递给 DragGestureListener 的 dragGestureRecognized() 方法。

另请参见:
DragGestureRecognizer, DragGestureListener, DragSource, 序列化表格

字段摘要
 
从类 java.util.EventObject 继承的字段
source
 
构造方法摘要
DragGestureEvent(DragGestureRecognizer dgr, int act, Point ori, List<? extends InputEvent> evs)
          在给定激发此事件的 DragGestureRecognizer、表示用户首选操作的 int、指出拖动原点的 Point,以及组成操作的事件 List 的情况下,构造一个 DragGestureEvent
 
方法摘要
 Component getComponent()
          返回与此 DragGestureEvent 关联的 Component
 int getDragAction()
          返回用户所选操作的 int 表示形式。
 Point getDragOrigin()
          返回 Component 坐标中开始拖动位置的 Point
 DragSource getDragSource()
          返回 DragSource
 DragGestureRecognizer getSourceAsDragGestureRecognizer()
          以 DragGestureRecognizer 的形式返回拖动源。
 InputEvent getTriggerEvent()
          返回触发操作的初始事件。
 Iterator<InputEvent> iterator()
          返回组成操作的事件 Iterator
 void startDrag(Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl)
          在给定要显示的初始 Cursor、拖动 ImageImage 的偏移量、Transferable 对象和要使用的 DragSourceListener 的情况下开始拖动。
 void startDrag(Cursor dragCursor, Transferable transferable)
          在给定拖动操作的 Cursor 和表示拖动操作源数据的 Transferable 的情况下开始此拖动操作。
 void startDrag(Cursor dragCursor, Transferable transferable, DragSourceListener dsl)
          在给定要显示的初始 CursorTransferable 对象和要使用的 DragSourceListener 的情况下开始拖动。
 Object[] toArray()
          返回组成拖动操作的事件 Object 数组。
 Object[] toArray(Object[] array)
          返回组成拖动操作的事件数组。
 
从类 java.util.EventObject 继承的方法
getSource, toString
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

DragGestureEvent

public DragGestureEvent(DragGestureRecognizer dgr,
                        int act,
                        Point ori,
                        List<? extends InputEvent> evs)
在给定激发此事件的 DragGestureRecognizer、表示用户首选操作的 int、指出拖动原点的 Point,以及组成操作的事件 List 的情况下,构造一个 DragGestureEvent

参数:
dgr - 激发此事件的 DragGestureRecognizer
act - 用户的首选操作
ori - 拖动的原点
evs - 组成该操作的事件 List

抛出:
IllegalArgumentException - 如果输入参数为 null
方法详细信息

getSourceAsDragGestureRecognizer

public DragGestureRecognizer getSourceAsDragGestureRecognizer()
DragGestureRecognizer 的形式返回拖动源。

返回:
DragGestureRecognizer 形式的拖动源。

getComponent

public Component getComponent()
返回与此 DragGestureEvent 关联的 Component

返回:
Component

getDragSource

public DragSource getDragSource()
返回 DragSource

返回:
DragSource

getDragOrigin

public Point getDragOrigin()
返回 Component 坐标中开始拖动位置的 Point

返回:
Component 坐标中开始拖动位置的 Point。

iterator

public Iterator<InputEvent> iterator()
返回组成操作的事件 Iterator

返回:
组成操作的事件 Iterator

toArray

public Object[] toArray()
返回组成拖动操作的事件 Object 数组。

返回:
组成操作的事件数组

toArray

public Object[] toArray(Object[] array)
返回组成拖动操作的事件数组。

参数:
array - EventObject 子(类型)数组

返回:
组成操作的事件数组

getDragAction

public int getDragAction()
返回用户所选操作的 int 表示形式。

返回:
用户选择的操作

getTriggerEvent

public InputEvent getTriggerEvent()
返回触发操作的初始事件。

返回:
操作序列中的首个“触发”事件

startDrag

public void startDrag(Cursor dragCursor,
                      Transferable transferable)
               throws InvalidDnDOperationException
在给定拖动操作的 Cursor 和表示拖动操作源数据的 Transferable 的情况下开始此拖动操作。
如果指定的 Cursornull,则不抛出异常,而是使用默认的拖动光标。
如果指定的 Transferablenull,则抛出 NullPointerException

参数:
dragCursor - 此拖动操作的 Cursor
transferable - 表示此拖动操作源数据的 Transferable
抛出:
InvalidDnDOperationException - 如果 Drag 和 Drop 系统不能发起拖动操作,或者如果用户试图开始拖动的同时仍在执行现有的拖动操作。
NullPointerException - 如果 Transferablenull
InvalidDnDOperationException
从以下版本开始:
1.4

startDrag

public void startDrag(Cursor dragCursor,
                      Transferable transferable,
                      DragSourceListener dsl)
               throws InvalidDnDOperationException
在给定要显示的初始 CursorTransferable 对象和要使用的 DragSourceListener 的情况下开始拖动。

参数:
dragCursor - 初始的拖动 Cursor
transferable - 拖动源的 Transferable
dsl - 拖动源的 DragSourceListener

抛出:
InvalidDnDOperationException - 如果 Drag 和 Drop 系统不能发起拖动操作,或者如果用户试图开始拖动的同时仍在执行现有的拖动操作。
InvalidDnDOperationException

startDrag

public void startDrag(Cursor dragCursor,
                      Image dragImage,
                      Point imageOffset,
                      Transferable transferable,
                      DragSourceListener dsl)
               throws InvalidDnDOperationException
在给定要显示的初始 Cursor、拖动 ImageImage 的偏移量、Transferable 对象和要使用的 DragSourceListener 的情况下开始拖动。

参数:
dragCursor - 初始的拖动 Cursor
dragImage - 拖动源的 dragImage
imageOffset - dragImage 的偏移量
transferable - 拖动源的 Transferable
dsl - 拖动源的 DragSourceListener

抛出:
InvalidDnDOperationException - 如果 Drag 和 Drop 系统不能发起拖动操作,或者如果用户试图开始拖动的同时仍在执行现有的拖动操作。
InvalidDnDOperationException

JavaTM 2 Platform
Standard Ed. 5.0

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

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