java.awt.dnd

Class DragSourceDragEvent

java.lang.Object

java.util.EventObject

java.awt.dnd.DragSourceEvent

java.awt.dnd.DragSourceDragEvent

All Implemented Interfaces:

Serializable

public class DragSourceDragEvent
extends DragSourceEvent

该DragSourceDragEvent从交付DragSourceContextPeer ，通过DragSourceContext ，到DragSourceListener与注册DragSourceContext和与其相关DragSource 。

DragSourceDragEvent报告了目标放置操作和反映当前拖动操作状态的用户放置操作 。

目标放置操作是DnDConstants中的一个，表示当拖动源支持该拖放操作时，当前放置目标选择的放置操作， DnDConstants.ACTION_NONE如果拖放源不支持此放置操作。

用户放置操作取决于拖动源支持的放置操作和用户选择的放置操作。 用户可以在拖动操作期间按修改键来选择放置操作：

  Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE 

如果用户选择放置操作，则用户放置操作是DnDConstants中的一个，表示当拖动源DnDConstants.ACTION_NONE该放置操作时所选择的放置操作，或DnDConstants.ACTION_NONE如果此拖动操作不受拖动源支持）。

如果用户没有选择降动作，一套DnDConstants表示设置拖动源支持的放置动作中搜索DnDConstants.ACTION_MOVE ，然后DnDConstants.ACTION_COPY ，然后为DnDConstants.ACTION_LINK和用户drop操作是找到的第一个常量。 如果没有找到常量，则用户删除操作是DnDConstants.ACTION_NONE 。

从以下版本开始：

1.2

另请参见：

Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers) 构造一个 DragSourceDragEvent 。
DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y) 构造一个 DragSourceDragEvent给指定的 DragSourceContext ，用户放置动作，目标放置动作，改性剂和坐标。

方法摘要

Modifier and Type	Method and Description
int	getDropAction() 此方法返回目标放置操作与拖动源支持的放置操作集合的逻辑交集。
int	getGestureModifiers() 该方法返回一个 int ，表示与用户手势相关联的输入设备修饰符的当前状态。
int	getGestureModifiersEx() 该方法返回一个 int表示与用户手势相关联的输入设备扩展修饰符的当前状态。
int	getTargetActions() 此方法返回目标放置操作。
int	getUserAction() 此方法返回用户放置操作。

Methods inherited from class java.awt.dnd.DragSourceEvent

getDragSourceContext, getLocation, getX, getY

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

构造方法详细信息

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int action,
                           int modifiers)

构造一个DragSourceDragEvent 。 该类通常由DragSourceContextPeer而不是直接由客户端代码DragSourceContextPeer 。 此DragSourceDragEvent的DragSourceDragEvent未指定，因此getLocation将返回null此事件。

参数dropAction和action应为DnDConstants ，表示单个操作。 参数modifiers应该是旧的java.awt.event.InputEvent.*_MASK常数的按位掩码或扩展的java.awt.event.InputEvent.*_DOWN_MASK常量的按位掩码。 此构造方法不抛出无效任何异常dropAction ， action和modifiers 。

参数

dsc -该 DragSourceContext那就是管理此事件通知。

dropAction - 用户删除操作。

action - 目标放置操作。

modifiers - 在事件期间修改器键（shift，ctrl，alt，meta）应该使用扩展_DOWN_MASK或旧_MASK修饰符，但是两个模型不应该在一个事件中混合。 优选使用延伸改性剂。

异常

IllegalArgumentException - 如果 dsc是 null 。

另请参见：

InputEvent ， DragSourceEvent.getLocation()

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int action,
                           int modifiers,
                           int x,
                           int y)

构造一个DragSourceDragEvent给指定的DragSourceContext ，用户放置动作，目标放置动作，改性剂和坐标。

参数dropAction和action应为DnDConstants ，表示单个操作。 参数modifiers应该是旧的java.awt.event.InputEvent.*_MASK常数的按位掩码或扩展的java.awt.event.InputEvent.*_DOWN_MASK常量的按位掩码。 此构造方法不抛出无效任何异常dropAction ， action和modifiers 。

参数

dsc - 与此事件 DragSourceContext DragSourceContext。

dropAction - 用户删除操作。

action - 目标下降动作。

modifiers - 在事件期间修改器按键（shift，ctrl，alt，meta）应该使用扩展_DOWN_MASK或旧_MASK修饰符，但是两个模型不应该在一个事件中混合。 优选使用延伸改性剂。

x - 光标位置的水平坐标

y - 光标位置的垂直坐标

异常

IllegalArgumentException - 如果 dsc是 null 。

从以下版本开始：

1.4

另请参见：

InputEvent

方法详细信息

getTargetActions

public int getTargetActions()

此方法返回目标放置操作。

结果

目标放下动作。

getGestureModifiers

public int getGestureModifiers()

该方法返回一个int ，表示与用户手势相关联的输入设备修饰符的当前状态。 通常这些将是鼠标按钮或键盘修饰符。

如果modifiers传递到构造无效，则此方法按原样返回它们。

结果

输入设备修改器的当前状态

getGestureModifiersEx

public int getGestureModifiersEx()

该方法返回一个int表示与用户手势相关联的输入设备扩展修饰符的当前状态。 见InputEvent.getModifiersEx()

如果modifiers传递到构造无效，则此方法按原样返回它们。

结果

输入设备的当前状态扩展修改器

从以下版本开始：

1.4

getUserAction

public int getUserAction()

此方法返回用户放置操作。

结果

用户放下动作。

getDropAction

public int getDropAction()

此方法返回目标放置操作与拖动源支持的放置操作集合的逻辑交集。

结果

目标放置操作与拖动源支持的放置操作集合的逻辑交集。