public abstract class DragSourceAdapter extends Object implements DragSourceListener, DragSourceMotionListener
Extend this class to create a DragSourceEvent
listener
and override the methods for the events of interest. (If you implement the
DragSourceListener
interface, you have to define all of
the methods in it. This abstract class defines null methods for them
all, so you only have to define methods for events you care about.)
Create a listener object using the extended class and then register it with
a DragSource
. When the drag enters, moves over, or exits
a drop site, when the drop action changes, and when the drag ends, the
relevant method in the listener object is invoked, and the
DragSourceEvent
is passed to it.
The drop site is associated with the previous dragEnter()
invocation if the latest invocation of dragEnter()
on this
adapter corresponds to that drop site and is not followed by a
dragExit()
invocation on this adapter.
DragSourceEvent
,
DragSourceListener
,
DragSourceMotionListener
Constructor and Description |
---|
DragSourceAdapter() |
Modifier and Type | Method and Description |
---|---|
void |
dragDropEnd(DragSourceDropEvent dsde)
This method is invoked to signify that the Drag and Drop
operation is complete.
|
void |
dragEnter(DragSourceDragEvent dsde)
Called as the cursor's hotspot enters a platform-dependent drop site.
|
void |
dragExit(DragSourceEvent dse)
Called as the cursor's hotspot exits a platform-dependent drop site.
|
void |
dragMouseMoved(DragSourceDragEvent dsde)
Called whenever the mouse is moved during a drag operation.
|
void |
dragOver(DragSourceDragEvent dsde)
Called as the cursor's hotspot moves over a platform-dependent drop site.
|
void |
dropActionChanged(DragSourceDragEvent dsde)
Called when the user has modified the drop gesture.
|
public void dragEnter(DragSourceDragEvent dsde)
dragEnter
in interface DragSourceListener
dsde
- the DragSourceDragEvent
public void dragOver(DragSourceDragEvent dsde)
dragOver
in interface DragSourceListener
dsde
- the DragSourceDragEvent
public void dragMouseMoved(DragSourceDragEvent dsde)
dragMouseMoved
in interface DragSourceMotionListener
dsde
- the DragSourceDragEvent
public void dropActionChanged(DragSourceDragEvent dsde)
dropActionChanged
in interface DragSourceListener
dsde
- the DragSourceDragEvent
public void dragExit(DragSourceEvent dse)
dragExit
in interface DragSourceListener
dse
- the DragSourceEvent
public void dragDropEnd(DragSourceDropEvent dsde)
DragSourceDropEvent
can be used to
determine the termination state. The getDropAction() method
returns the operation that the drop site selected
to apply to the Drop operation. Once this method is complete, the
current DragSourceContext
and
associated resources become invalid.dragDropEnd
in interface DragSourceListener
dsde
- the DragSourceDropEvent
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.