模块 java.desktop
包 java.awt.dnd

类 DragGestureEvent

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

  • 构造方法详细信息

    • DragGestureEvent

      public DragGestureEvent(DragGestureRecognizer  dgr, int act, Point  ori, List <? extends InputEvent > evs)
      构造由触发此事件的 DragGestureRecognizer 实例给出的 DragGestureEvent 对象、表示用户首选操作的 act 参数、指示拖动来源的 ori 参数以及构成手势的 List 事件（evs 参数）。
      参数：
      dgr - DragGestureRecognizer 触发此事件
      act - 用户的首选操作。有关允许值的信息，请参阅 DragGestureEvent 的类描述
      ori - 拖动的起源
      evs - 构成手势的事件的 List
      抛出：
      IllegalArgumentException - 如果任何参数等于 null
      IllegalArgumentException - 如果 act 参数不符合 DragGestureEvent 类描述中给出的值
      参见：

  • 方法详情

    • getSourceAsDragGestureRecognizer

      public DragGestureRecognizer  getSourceAsDragGestureRecognizer()
      将源作为 DragGestureRecognizer 返回。
      返回：
      来源为DragGestureRecognizer

    • getComponent

      public Component  getComponent()
      返回与此 DragGestureEvent 关联的 Component。
      返回：
      组件

    • getDragSource

      public DragSource  getDragSource()
      返回 DragSource 。
      返回：
      DragSource

    • getDragOrigin

      public Point  getDragOrigin()
      返回拖动起源的 Component 坐标中的 Point。
      返回：
      Component 坐标中拖动起源的 Point。

    • iterator

      public Iterator <InputEvent > iterator()
      为包含手势的事件返回一个 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 - 如果拖放系统无法启动拖动操作，或者如果用户尝试在现有拖动操作仍在执行时开始拖动。