模块  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

        参数dropActionaction应该是代表单个动作的DnDConstants之一。 参数modifiers应该是旧的java.awt.event.InputEvent.*_MASK常量的按位掩码或扩展的java.awt.event.InputEvent.*_DOWN_MASK常量的按位掩码。 此构造方法不抛出无效任何异常dropActionactionmodifiers

        参数
        dsc - 用于管理此事件通知的 DragSourceContext
        dropAction - 用户放置操作。
        action - 目标放下操作。
        modifiers - 事件期间修改键按下(shift,ctrl,alt,meta)应使用扩展的_DOWN_MASK或旧的_MASK修饰符,但两个模型不应在一个事件中混合使用。 优选使用延长改性剂。
        异常
        IllegalArgumentException - 如果 dscnull
        另请参见:
        InputEventDragSourceEvent.getLocation()
      • DragSourceDragEvent

        public DragSourceDragEvent​(DragSourceContext dsc,
                                   int dropAction,
                                   int action,
                                   int modifiers,
                                   int x,
                                   int y)
        根据指定的DragSourceContext ,用户放置操作,目标放置操作,修改器和坐标构造DragSourceDragEvent

        参数dropActionaction应该是DnDConstants中的一个,表示单个操作。 参数modifiers应该是旧的java.awt.event.InputEvent.*_MASK常量的按位掩码或扩展的java.awt.event.InputEvent.*_DOWN_MASK常量的按位掩码。 此构造方法不抛出无效任何异常dropActionactionmodifiers

        参数
        dsc - 与此活动相关的 DragSourceContext
        dropAction - 用户放置操作。
        action - 目标放下动作。
        modifiers - 事件期间修改键向下键(shift,ctrl,alt,meta)应使用扩展_DOWN_MASK或旧_MASK修饰符,但两个模型不应混合在一个事件中。 优选使用延长改性剂。
        x - 光标位置的水平坐标
        y - 光标位置的垂直坐标
        异常
        IllegalArgumentException - 如果 dscnull
        从以下版本开始:
        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()
        此方法返回目标放置操作和拖动源支持的放置操作集的逻辑交集。
        结果
        目标放置操作与拖动源支持的放置操作集的逻辑交集。