Module  java.desktop
软件包  java.awt.dnd

Class DragSourceDragEvent

  • All Implemented Interfaces:
    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如果拖放源不支持此放置操作。

    如果用户没有选drop操作，一组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)
        构造一个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
        另请参见：
        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​()
        此方法返回目标放置操作与拖动源支持的放置操作集合的逻辑交集。
        结果
        目标放置操作与拖动源支持的放置操作集合的逻辑交集。