Question

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(DragGestureRecognizerdgr, intact, Pointori, 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(CursordragCursor, ImagedragImage, PointimageOffset, Transferabletransferable, DragSourceListenerdsl) 在给定要显示的初始 Cursor 、拖动 Image 、 Image 的偏移量、 Transferable 对象和要使用的 DragSourceListener 的情况下开始拖动。
void	startDrag(CursordragCursor, Transferabletransferable) 在给定拖动操作的 Cursor 和表示拖动操作源数据的 Transferable 的情况下开始此拖动操作。
void	startDrag(CursordragCursor, Transferabletransferable, DragSourceListenerdsl) 在给定要显示的初始 Cursor 、 Transferable 对象和要使用的 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(DragGestureRecognizerdgr,
                        intact,
                        Pointori,
                        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(CursordragCursor,
                      Transferabletransferable)
               throws InvalidDnDOperationException

在给定拖动操作的 Cursor 和表示拖动操作源数据的 Transferable 的情况下开始此拖动操作。 如果指定的 Cursor 为 null ，则不抛出异常，而是使用默认的拖动光标。 如果指定的 Transferable 为 null ，则抛出 NullPointerException 。

参数：

dragCursor - 此拖动操作的 Cursor

transferable - 表示此拖动操作源数据的 Transferable 。

抛出：

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

NullPointerException - 如果 Transferable 为 null 。

InvalidDnDOperationException

从以下版本开始：

1.4

---

startDrag

public void startDrag(CursordragCursor,
                      Transferabletransferable,
                      DragSourceListenerdsl)
               throws InvalidDnDOperationException

在给定要显示的初始 Cursor 、 Transferable 对象和要使用的 DragSourceListener 的情况下开始拖动。

参数：

dragCursor - 初始的拖动 Cursor

transferable - 拖动源的 Transferable

dsl - 拖动源的 DragSourceListener

抛出：

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

InvalidDnDOperationException

---

startDrag

public void startDrag(CursordragCursor,
                      ImagedragImage,
                      PointimageOffset,
                      Transferabletransferable,
                      DragSourceListenerdsl)
               throws InvalidDnDOperationException

在给定要显示的初始 Cursor 、拖动 Image 、 Image 的偏移量、 Transferable 对象和要使用的 DragSourceListener 的情况下开始拖动。

参数：

dragCursor - 初始的拖动 Cursor

dragImage - 拖动源的 dragImage

imageOffset - dragImage 的偏移量

transferable - 拖动源的 Transferable

dsl - 拖动源的 DragSourceListener

抛出：

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

InvalidDnDOperationException