java.awt.dnd
类 DragSourceDragEvent

java.lang.Object
  java.util.EventObject
      java.awt.dnd.DragSourceEvent
          java.awt.dnd.DragSourceDragEvent

所有已实现的接口：

Serializable

public class DragSourceDragEvent
extends DragSourceEvent

通过 DragSourceContext，将 DragSourceDragEvent 从 DragSourceContextPeer 传递给向 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener

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

目标放置动作 是 DnDConstants 之一，如果拖动源支持此放置动作，则表示当前放置目标所选择的放置动作，否则如果拖动源不支持此放置动作，则为 DnDConstants.ACTION_NONE。

用户放置动作 则取决于拖动源所支持的放置动作和用户所选择的放置动作。用户可在拖动操作期间按下组合键来选择放置动作：

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

如果用户选择了某个放置动作，则用户放置动作 是 DnDConstants 之一，如果拖动源支持此放置动作，则表示所选择的放置动作，否则如果拖动源不支持此放置动作，则为 DnDConstants.ACTION_NONE。

如果用户未选择某个放置动作，则在表示拖动源支持的放置动作集合的 DnDConstants 集合中搜索 DnDConstants.ACTION_MOVE 和 DnDConstants.ACTION_COPY，然后搜索 DnDConstants.ACTION_LINK，找到的第一个常量就是用户放置动作 如果未找到常量，则用户放置动作 为 DnDConstants.ACTION_NONE。

从以下版本开始：

1.2

另请参见：

序列化表格

字段摘要

从类 java.util.EventObject 继承的字段

source

构造方法摘要

DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers)
构造一个 DragSourceDragEvent 此类通常是由 DragSourceContextPeer 实例化，而不是直接由客户机代码实例化。

DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y)
构造一个具有指定 DragSourceContext、用户放置动作、目标放置动作、组合键和坐标的的 DragSourceDragEvent。

方法摘要

int	getDropAction() 此方法返回用户放置动作、目标放置动作和拖动源支持的放置动作集合的逻辑交集。
int	getGestureModifiers() 此方法返回一个 int 值，表示与用户动作关联的输入设备组合键的当前状态。
int	getGestureModifiersEx() 此方法返回一个 int 值，表示与用户动作关联的输入设备扩展组合键的当前状态。
int	getTargetActions() 此方法返回目标放置动作。
int	getUserAction() 此方法返回用户放置动作。

从类 java.awt.dnd.DragSourceEvent 继承的方法

getDragSourceContext, getLocation, getX, getY

从类 java.util.EventObject 继承的方法

getSource, toString

从类 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 实例化，而不是直接由客户机代码实例化。未指定此 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)

构造一个具有指定 DragSourceContext、用户放置动作、目标放置动作、组合键和坐标的的 DragSourceDragEvent。

参数 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 组合键，但是在一个事件中不应混用两种模型。首选使用扩展组合键。

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()

此方法返回用户放置动作、目标放置动作和拖动源支持的放置动作集合的逻辑交集。

返回：

用户放置动作、目标放置动作和拖动源支持的放置动作集合的逻辑交集。