Module java.desktop
Package java.awt.dnd

Class 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.ACTION_MOVE，然后搜索DnDConstants.ACTION_COPY，然后搜索DnDConstants.ACTION_LINK，并且用户放置操作是找到的第一个常量。如果未找到任何常量，则用户放置操作为DnDConstants.ACTION_NONE。

自从:
1.2
参见:

  • Constructor Details

    • 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)
      给定指定的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
      参见:

  • Method Details

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