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

Class DragGestureEvent

  • 实现的所有接口
    Serializable 
    public class DragGestureEvent
extends EventObject
    当特定的DragGestureRecognizer检测到正在跟踪的Component上发生了与平台相关的拖动启动手势时， DragGestureEvent将传递给DragGestureListener的dragGestureRecognized（）方法。 任何DragGestureEvent实例的action字段应采用以下值之一：
    • DnDConstants.ACTION_COPY
    • DnDConstants.ACTION_MOVE
    • DnDConstants.ACTION_LINK
    分配与上面列出的值不同的值将导致未指定的行为。
    另请参见：
    DragGestureRecognizer ， DragGestureListener ， DragSource ， DnDConstants ， Serialized Form

    • 构造方法详细信息

      • DragGestureEvent

        public DragGestureEvent​(DragGestureRecognizer dgr,
                        int act,
                        Point ori,
                        List<? extends InputEvent> evs)
        构造一个 DragGestureEvent由给定对象 DragGestureRecognizer实例激发此事件中， act表示用户的首选操作参数，一个 ori参数指示拖动原点，和一个 List组成动作（事件 evs参数）。
        参数
        dgr - DragGestureRecognizer触发此事件
        act - 用户首选的操作。 有关允许值的信息，请参阅DragGestureEvent的类说明
        ori - 拖动的原点
        evs - 构成手势的事件的 List
        异常
        IllegalArgumentException - 如果任何参数等于 null
        IllegalArgumentException - 如果act参数不符合类描述中给出的值DragGestureEvent
        另请参见：
        DnDConstants

    • 方法详细信息

      • getSourceAsDragGestureRecognizer

        public DragGestureRecognizer getSourceAsDragGestureRecognizer()
        以 DragGestureRecognizer返回源。
        结果
        来源为 DragGestureRecognizer

      • getComponent

        public Component getComponent()
        返回与 Component相关联的 DragGestureEvent 。
        结果
        组件

      • getDragSource

        public DragSource getDragSource()
        返回 DragSource 。
        结果
        DragSource

      • getDragOrigin

        public Point getDragOrigin()
        返回 Point在坐标 Component在开始拖动。
        结果
        拖动起源于组件坐标的点。

      • iterator

        public Iterator<InputEvent> iterator()
        返回包含手势的事件的 Iterator 。
        结果
        包含手势的事件的迭代器

      • toArray

        public Object[] toArray()
        返回包含拖动手势的事件的 Object数组。
        结果
        包含手势的事件的数组

      • toArray

        public Object[] toArray​(Object[] array)
        返回包含拖动手势的事件数组。
        参数
        array - 数组 EventObject子（类型）
        结果
        包含手势的事件的数组

      • getDragAction

        public int getDragAction()
        返回表示用户选择的操作的 int 。
        结果
        用户选择的动作

      • getTriggerEvent

        public InputEvent getTriggerEvent()
        返回触发手势的初始事件。
        结果
        手势序列中的第一个“触发”事件

      • startDrag

        public void startDrag​(Cursor dragCursor,
                      Transferable transferable)
               throws InvalidDnDOperationException
        给定此拖动操作的Transferable表示此拖动操作的源数据的Cursor ，启动拖动操作。
        如果指定了null Cursor则不会抛出异常，而是使用默认的拖动游标。
        如果null Transferable指定NullPointerException将被抛出。
        参数
        dragCursor - 此拖动操作的初始Cursor null ，默认null ; 有关拖放期间光标处理机制的更多详细信息，请参阅DragSourceContext
        transferable - Transferable表示此拖动操作的源数据。
        异常
        InvalidDnDOperationException - 如果拖放系统无法启动拖动操作，或者用户在现有拖动操作仍在执行时尝试启动拖动。
        NullPointerException - 如果 Transferable是 null
        从以下版本开始：
        1.4

      • startDrag

        public void startDrag​(Cursor dragCursor,
                      Transferable transferable,
                      DragSourceListener dsl)
               throws InvalidDnDOperationException
        给出要显示的初始 Cursor Transferable对象和要使用的 DragSourceListener ，开始拖动。
        参数
        dragCursor - 此拖动操作的初始Cursor null ，默认null ; 有关拖放期间光标处理机制的更多详细信息，请参见DragSourceContext
        transferable - 来源的可转让
        dsl - 源的DragSourceListener
        异常
        InvalidDnDOperationException - 如果拖放系统无法启动拖动操作，或者用户在现有拖动操作仍在执行时尝试启动拖动。

      • startDrag

        public void startDrag​(Cursor dragCursor,
                      Image dragImage,
                      Point imageOffset,
                      Transferable transferable,
                      DragSourceListener dsl)
               throws InvalidDnDOperationException
        启动给定的初始拖拽 Cursor显示，拖动 Image ，所述的偏移 Image ，所述 Transferable对象和 DragSourceListener使用。
        参数
        dragCursor - 此拖动操作的初始Cursor null ，默认光标处理的初始Cursor null ; 有关拖放期间光标处理机制的更多详细信息，请参阅DragSourceContext
        dragImage - 源的dragImage
        imageOffset - dragImage的偏移量
        transferable - 来源的可转让
        dsl - 源的DragSourceListener
        异常
        InvalidDnDOperationException - if the Drag and Drop system is unable to initiate a drag operation, or if the user attempts to start a drag while an existing drag operation is still executing.