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

Constructor Detail

DragGestureEvent

public DragGestureEvent(DragGestureRecognizer dgr,
                        int act,
                        Point ori,
                        List<? extends InputEvent> evs)

构建了由 DragGestureRecognizer实例射击这一事件给出一个 DragGestureEvent对象，一个 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的阻力源。

结果

点的阻力源于组件的坐标。

iterator

public Iterator<InputEvent> 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拖动操作。
如果 null Cursor没有指定异常将被抛出，将使用默认拖动光标。
如果 null Transferable指定 NullPointerException将抛出。

参数

dragCursor为默认光标处理这个拖动操作或 null初始 Cursor；见的鼠标拖放在处理机制的更多细节 DragSourceContext

transferable代表这个拖动操作的源数据的 Transferable。

异常

InvalidDnDOperationException如果拖放系统无法启动拖动操作，或者如果用户试图在现有的拖动操作仍执行开始拖动。

NullPointerException -如果 Transferable是 null

从以下版本开始：

一点四

startDrag

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

开始给显示的初始 Cursor阻力的 Transferable对象，和 DragSourceListener使用。

参数

dragCursor为默认光标处理这个拖动操作或 null初始 Cursor；见的鼠标拖放在处理机制的更多细节 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为默认光标处理这个拖动操作或 null初始 Cursor；见的鼠标拖放在处理机制的更多细节 DragSourceContext

dragImage -源的dragimage

imageOffset - dragimage的偏移

transferable -源的转让

dsl -源的dragsourcelistener

异常

InvalidDnDOperationException如果拖放系统无法启动拖动操作，或者如果用户试图在现有的拖动操作仍执行开始拖动。