模块 java.desktop
包 java.awt.dnd

类 DragSourceDragEvent

java.lang.Object
java.util.EventObject
java.awt.dnd.DragSourceEvent
java.awt.dnd.DragSourceDragEvent
所有已实现的接口：
Serializable
public class DragSourceDragEvent extends DragSourceEvent
DragSourceDragEvent 从 DragSourceContextPeer 通过 DragSourceContext 传送到向该 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
参见：

  • 构造方法详细信息

    • 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。
      参见：

    • 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。
      dropAction - 用户放下操作。
      action - 目标下降动作。
      modifiers - 事件期间按下修饰键（shift、ctrl、alt、meta）应使用扩展的 _DOWN_MASK 或旧的 _MASK 修饰符，但两种模型不应在一个事件中混合使用。首选使用扩展修饰符。
      x - 光标位置的水平坐标
      y - 光标位置的垂直坐标
      抛出：
      IllegalArgumentException - 如果 dsc 是 null。
      自从：
      1.4
      参见：

  • 方法详情

    • 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()
      此方法返回目标放置操作与拖动源支持的放置操作集的逻辑交集。
      返回：
      目标放置操作和拖动源支持的放置操作集的逻辑交集。