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

Class DragGestureEvent

  • All Implemented Interfaces:
    Serializable 

    public class DragGestureEvent
extends EventObject
    甲DragGestureEvent被传递给DragGestureListener的dragGestureRecognized（）方法时的具体DragGestureRecognizer检测到已经发生了一个平台相关的拖动启动手势的Component它正在跟踪。 任何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
        开始拖动操作，给出Cursor用于此拖动操作， Transferable表示此拖动操作的源数据。
        如果指定了一个null Cursor则不会抛出任何异常，并使用默认拖动光标。
        如果null Transferable指定NullPointerException将被抛出。
        参数
        dragCursor - 这个拖动操作的初始Cursor或默认光标处理的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 ; 有关拖放中光标处理机制的更多详细信息，请参阅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 ; 有关拖放时光标处理机制的详细信息，请参阅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.