Java java.awt.dnd Class DragGestureEvent（JDK8）

Constructor Detail

• 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:

  DnDConstants

Method Detail

• 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.