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

Class DragGestureEvent

  • 实现的所有接口
    Serializable

    public class DragGestureEventextends EventObject
    当特定的DragGestureRecognizer检测到正在跟踪的Component上发生了与平台相关的拖动启动手势时, DragGestureEvent将传递给DragGestureListener的dragGestureRecognized()方法。 任何DragGestureEvent实例的action字段应采用以下值之一:
    • DnDConstants.ACTION_COPY
    • DnDConstants.ACTION_MOVE
    • DnDConstants.ACTION_LINK
    分配与上面列出的值不同的值将导致未指定的行为。
    另请参见:
    DragGestureRecognizerDragGestureListenerDragSourceDnDConstantsSerialized 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 - 如果 Transferablenull
        从以下版本开始:
        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.