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、拖动 Image、Image 的偏移量、Transferable 对象和要使用的 DragSourceListener 的情况下开始拖动。
void	startDrag(Cursor dragCursor, Transferable transferable) 在给定拖动操作的 Cursor 和表示拖动操作源数据的 Transferable 的情况下开始此拖动操作。
void	startDrag(Cursor dragCursor, Transferable transferable, DragSourceListener dsl) 在给定要显示的初始 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(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 的情况下开始此拖动操作。
如果指定的 Cursor 为 null，则不抛出异常，而是使用默认的拖动光标。
如果指定的 Transferable 为 null，则抛出 NullPointerException。

参数：

dragCursor - 此拖动操作的 Cursor

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

抛出：

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

NullPointerException - 如果 Transferable 为 null。

InvalidDnDOperationException

从以下版本开始：

1.4

startDrag

public void startDrag(Cursor dragCursor,
                      Transferable transferable,
                      DragSourceListener dsl)
               throws InvalidDnDOperationException

在给定要显示的初始 Cursor、Transferable 对象和要使用的 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、拖动 Image、Image 的偏移量、Transferable 对象和要使用的 DragSourceListener 的情况下开始拖动。

参数：

dragCursor - 初始的拖动 Cursor

dragImage - 拖动源的 dragImage

imageOffset - dragImage 的偏移量

transferable - 拖动源的 Transferable

dsl - 拖动源的 DragSourceListener

抛出：

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

InvalidDnDOperationException