Module java.desktop
Package java.awt.dnd

Class DragGestureEvent

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

  • Constructor Details

    • 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类描述中给定的值
      参见:

  • Method Details

    • getSourceAsDragGestureRecognizer

      public DragGestureRecognizer getSourceAsDragGestureRecognizer()
      返回作为DragGestureRecognizer的源。
      返回:
      作为DragGestureRecognizer的源

    • getComponent

      public Component getComponent()
      返回与此DragGestureEvent关联的Component。
      返回:
      该Component

    • getDragSource

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

    • getDragOrigin

      public Point getDragOrigin()
      返回拖动起始点在Component坐标中的Point。
      返回:
      拖动起始点在组件坐标中的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 - 源的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 - 源的拖动Image
      imageOffset - 拖动Image的偏移
      transferable - 源的Transferable
      dsl - 源的DragSourceListener
      抛出:
      InvalidDnDOperationException - 如果拖放系统无法启动拖动操作，或者用户尝试在现有拖动操作仍在执行时启动拖动操作。