Class DragGestureEvent

java.lang.Object
java.util.EventObject
java.awt.dnd.DragGestureEvent
All Implemented Interfaces:
Serializable
public class DragGestureEvent extends EventObject
A DragGestureEvent is passed to DragGestureListener's dragGestureRecognized() method when a particular DragGestureRecognizer detects that a platform dependent drag initiating gesture has occurred on the Component that it is tracking. The action field of any DragGestureEvent instance should take one of the following values:
  • DnDConstants.ACTION_COPY
  • DnDConstants.ACTION_MOVE
  • DnDConstants.ACTION_LINK
Assigning the value different from listed above will cause an unspecified behavior.
See Also:

  • Field Summary

    Fields declared in class EventObject

    source
    Modifier and Type
    Field
    Description
    protected Object
    source
    The object on which the Event initially occurred.

  • Constructor Summary

    Constructors
    Constructor
    Description
    DragGestureEvent(DragGestureRecognizer dgr, int act, Point ori, List<? extends InputEvent> evs)
    Constructs a DragGestureEvent object given by the DragGestureRecognizer instance firing this event, an act parameter representing the user's preferred action, an ori parameter indicating the origin of the drag, and a List of events that comprise the gesture(evs parameter).

  • Method Summary

    Modifier and Type
    Method
    Description
    Component
    getComponent()
    Returns the Component associated with this DragGestureEvent.
    int
    getDragAction()
    Returns an int representing the action selected by the user.
    Point
    getDragOrigin()
    Returns a Point in the coordinates of the Component over which the drag originated.
    DragSource
    getDragSource()
    Returns the DragSource.
    DragGestureRecognizer
    getSourceAsDragGestureRecognizer()
    Returns the source as a DragGestureRecognizer.
    InputEvent
    getTriggerEvent()
    Returns the initial event that triggered the gesture.
    Iterator<InputEvent>
    iterator()
    Returns an Iterator for the events comprising the gesture.
    void
    startDrag(Cursor dragCursor, Transferable transferable)
    Starts the drag operation given the Cursor for this drag operation and the Transferable representing the source data for this drag operation.
    void
    startDrag(Cursor dragCursor, Transferable transferable, DragSourceListener dsl)
    Starts the drag given the initial Cursor to display, the Transferable object, and the DragSourceListener to use.
    void
    startDrag(Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl)
    Start the drag given the initial Cursor to display, a drag Image, the offset of the Image, the Transferable object, and the DragSourceListener to use.
    Object[]
    toArray()
    Returns an Object array of the events comprising the drag gesture.
    Object[]
    toArray(Object[] array)
    Returns an array of the events comprising the drag gesture.

    Methods declared in class EventObject

    getSource, toString
    Modifier and Type
    Method
    Description
    Object
    getSource()
    The object on which the Event initially occurred.
    String
    toString()
    Returns a String representation of this EventObject.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Creates and returns a copy of this object.
    boolean
    equals(Object obj)
    Indicates whether some other object is "equal to" this one.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Finalization is deprecated and subject to removal in a future release.
    final Class<?>
    getClass()
    Returns the runtime class of this Object.
    int
    hashCode()
    Returns a hash code value for this object.
    final void
    notify()
    Wakes up a single thread that is waiting on this object's monitor.
    final void
    notifyAll()
    Wakes up all threads that are waiting on this object's monitor.
    final void
    wait()
    Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
    final void
    wait(long timeoutMillis)
    Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
    final void
    wait(long timeoutMillis, int nanos)
    Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

  • Constructor Details

    • DragGestureEvent

      public DragGestureEvent(DragGestureRecognizer dgr, int act, Point ori, List<? extends InputEvent> evs)
      Constructs a DragGestureEvent object given by the DragGestureRecognizer instance firing this event, an act parameter representing the user's preferred action, an ori parameter indicating the origin of the drag, and a List of events that comprise the gesture(evs parameter).
      Parameters:
      dgr - The DragGestureRecognizer firing this event
      act - The user's preferred action. For information on allowable values, see the class description for DragGestureEvent
      ori - The origin of the drag
      evs - The List of events that comprise the gesture
      Throws:
      IllegalArgumentException - if any parameter equals null
      IllegalArgumentException - if the act parameter does not comply with the values given in the class description for DragGestureEvent
      See Also:

  • Method Details

    • getSourceAsDragGestureRecognizer

      public DragGestureRecognizer getSourceAsDragGestureRecognizer()
      Returns the source as a DragGestureRecognizer.
      Returns:
      the source as a DragGestureRecognizer

    • getComponent

      public Component getComponent()
      Returns the Component associated with this DragGestureEvent.
      Returns:
      the Component

    • getDragSource

      public DragSource getDragSource()
      Returns the DragSource.
      Returns:
      the DragSource

    • getDragOrigin

      public Point getDragOrigin()
      Returns a Point in the coordinates of the Component over which the drag originated.
      Returns:
      the Point where the drag originated in Component coords.

    • iterator

      public Iterator<InputEvent> iterator()
      Returns an Iterator for the events comprising the gesture.
      Returns:
      an Iterator for the events comprising the gesture

    • toArray

      public Object[] toArray()
      Returns an Object array of the events comprising the drag gesture.
      Returns:
      an array of the events comprising the gesture

    • toArray

      public Object[] toArray(Object[] array)
      Returns an array of the events comprising the drag gesture.
      Parameters:
      array - the array of EventObject sub(types)
      Returns:
      an array of the events comprising the gesture

    • getDragAction

      public int getDragAction()
      Returns an int representing the action selected by the user.
      Returns:
      the action selected by the user

    • getTriggerEvent

      public InputEvent getTriggerEvent()
      Returns the initial event that triggered the gesture.
      Returns:
      the first "triggering" event in the sequence of the gesture

    • startDrag

      public void startDrag(Cursor dragCursor, Transferable transferable) throws InvalidDnDOperationException
      Starts the drag operation given the Cursor for this drag operation and the Transferable representing the source data for this drag operation.
      If a null Cursor is specified no exception will be thrown and default drag cursors will be used instead.
      If a null Transferable is specified NullPointerException will be thrown.
      Parameters:
      dragCursor - The initial Cursor for this drag operation or null for the default cursor handling; see DragSourceContext for more details on the cursor handling mechanism during drag and drop
      transferable - The Transferable representing the source data for this drag operation.
      Throws:
      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.
      NullPointerException - if the Transferable is null
      Since:
      1.4

    • startDrag

      public void startDrag(Cursor dragCursor, Transferable transferable, DragSourceListener dsl) throws InvalidDnDOperationException
      Starts the drag given the initial Cursor to display, the Transferable object, and the DragSourceListener to use.
      Parameters:
      dragCursor - The initial Cursor for this drag operation or null for the default cursor handling; see DragSourceContext for more details on the cursor handling mechanism during drag and drop
      transferable - The source's Transferable
      dsl - The source's DragSourceListener
      Throws:
      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.

    • startDrag

      public void startDrag(Cursor dragCursor, Image dragImage, Point imageOffset, Transferable transferable, DragSourceListener dsl) throws InvalidDnDOperationException
      Start the drag given the initial Cursor to display, a drag Image, the offset of the Image, the Transferable object, and the DragSourceListener to use.
      Parameters:
      dragCursor - The initial Cursor for this drag operation or null for the default cursor handling; see DragSourceContext for more details on the cursor handling mechanism during drag and drop
      dragImage - The source's dragImage
      imageOffset - The dragImage's offset
      transferable - The source's Transferable
      dsl - The source's DragSourceListener
      Throws:
      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.