java.awt.dnd

Class DragGestureEvent

java.lang.Object

java.util.EventObject

java.awt.dnd.DragGestureEvent

All Implemented Interfaces:

Serializable

public class DragGestureEvent
extends EventObject

DragGestureEvent传递给DragGestureListener的dragGestureRecognized（）方法，当特定的DragGestureRecognizer检测到正在跟踪的Component上发生平台依赖的拖动启动手势时。 任何DragGestureEvent实例的action字段应该采用以下值之一：

• DnDConstants.ACTION_COPY
• DnDConstants.ACTION_MOVE
• DnDConstants.ACTION_LINK

分配与上述不同的值将导致未指定的行为。

另请参见：

DragGestureRecognizer ， DragGestureListener ， DragSource ， DnDConstants ， Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
DragGestureEvent(DragGestureRecognizer dgr, int act, Point ori, List<? extends InputEvent> evs) 构造一个 DragGestureEvent由给定对象 DragGestureRecognizer实例激发此事件中， act表示用户的首选操作参数， ori参数指示拖动原点，和 List组成动作（事件 evs参数）。

方法摘要

Modifier and Type	Method and Description
Component	getComponent() 返回 Component与此相关 DragGestureEvent 。
int	getDragAction() 返回一个 int ，表示用户选择的动作。
Point	getDragOrigin() 返回 Point在坐标 Component在开始拖动。
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) 返回包含拖动手势的事件数组。

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class 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)

构造一个 DragGestureEvent由给定对象 DragGestureRecognizer实例激发此事件中， act表示用户的首选操作参数， ori参数指示拖动原点，和 List组成动作（事件 evs参数）。

参数

dgr - DragGestureRecognizer这个事件

act - 用户的首选操作。 有关允许值的信息，请参阅DragGestureEvent的类说明

ori - 拖曳的起源

evs - 构成手势的事件的 List

异常

IllegalArgumentException - 如果任何参数等于 null

IllegalArgumentException -如果行为参数不符合在类描述中给出的数值DragGestureEvent

另请参见：

DnDConstants

方法详细信息

getSourceAsDragGestureRecognizer

public DragGestureRecognizer getSourceAsDragGestureRecognizer()

返回源为 DragGestureRecognizer 。

结果

来源为 DragGestureRecognizer

getComponent

public Component getComponent()

返回 Component与此相关 DragGestureEvent 。

结果

组件

getDragSource

public DragSource getDragSource()

返回 DragSource 。

结果

DragSource

getDragOrigin

public Point getDragOrigin()

返回一个 Point在Component Component上的拖动起源。

结果

拖动起始于组件坐标的点。

iterator

public Iterator<InputEvent> iterator()

对于包含手势的事件，返回 Iterator 。

结果

一个包含手势的事件的迭代器

toArray

public Object[] toArray()

返回一个 Object拖动手势的事件的一个 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表示此拖动操作的源数据。
如果指定了一个null Cursor ，则不会抛出任何异常，而将使用默认拖动光标。
如果null Transferable Transferable NullPointerException将被抛出。

参数

dragCursor - 这个拖动操作的初始Cursor Cursor或默认光标处理的null ; 有关拖放时光标处理机制的更多详细信息，请参阅DragSourceContext

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

异常

InvalidDnDOperationException - 如果拖放系统无法启动拖动操作，或者如果用户尝试在现有拖动操作仍在执行时启动拖动。

NullPointerException - 如果 Transferable是 null

从以下版本开始：

1.4

startDrag

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

开始拖动给予初始的 Cursor显示， Transferable对象和 DragSourceListener使用。

参数

dragCursor - 用于此拖动操作的初始Cursor Cursor或默认光标处理的null ; 有关拖放时光标处理机制的更多详细信息，请参阅DragSourceContext

transferable - 来源可转让

dsl - 源的DragSourceListener

异常

InvalidDnDOperationException - 如果拖放系统无法启动拖动操作，或者如果用户尝试在现有拖动操作仍在执行时启动拖动。

startDrag

public void startDrag(Cursor dragCursor,
                      Image dragImage,
                      Point imageOffset,
                      Transferable transferable,
                      DragSourceListener dsl)
               throws InvalidDnDOperationException

启动给定的初始拖拽 Cursor显示，拖动 Image ，所述的偏移 Image ，所述 Transferable对象和 DragSourceListener使用。

参数

dragCursor - 用于此拖动操作的初始Cursor Cursor或默认光标处理的null ; 有关拖放中光标处理机制的更多详细信息，请参阅DragSourceContext

dragImage - 源的dragImage

imageOffset - dragImage的偏移量

transferable - 来源可转让

dsl - 源的DragSourceListener

异常

InvalidDnDOperationException - if the Drag and Drop system is unable to initiate a drag operation, or if the user attempts to start a drag while an existing drag operation is still executing.