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。

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

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

返回：

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