模块  java.desktop
软件包  java.awt.dnd

Class DragSourceDragEvent

  • 实现的所有接口
    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表示设置拖动源支持的放置动作中搜索DnDConstants.ACTION_MOVE ，然后DnDConstants.ACTION_COPY ，然后DnDConstants.ACTION_LINK和用户drop操作是找到的第一个常量。 如果未找到常量，则用户删除操作为DnDConstants.ACTION_NONE 。

    从以下版本开始：
    1.2
    另请参见：
    Serialized Form

    • 构造方法详细信息

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