Serializable
DragSourceDragEvent
, DragSourceDropEvent
public class DragSourceEvent extends EventObject
DragSourceDragEvent
and DragSourceDropEvent
. DragSourceEvent
s are generated whenever the drag enters, moves over, or exits a drop site, when the drop action changes, and when the drag ends. The location for the generated DragSourceEvent
specifies the mouse cursor location in screen coordinates at the moment this event occurred.
In a multi-screen environment without a virtual device, the cursor location is specified in the coordinate system of the initiator GraphicsConfiguration
. The initiator GraphicsConfiguration
is the GraphicsConfiguration
of the Component
on which the drag gesture for the current drag operation was recognized. If the cursor location is outside the bounds of the initiator GraphicsConfiguration
, the reported coordinates are clipped to fit within the bounds of that GraphicsConfiguration
.
In a multi-screen environment with a virtual device, the location is specified in the corresponding virtual coordinate system. If the cursor location is outside the bounds of the virtual device the reported coordinates are clipped to fit within the bounds of the virtual device.
source
Constructor | Description |
---|---|
DragSourceEvent |
Construct a DragSourceEvent given a specified DragSourceContext . |
DragSourceEvent |
Construct a DragSourceEvent given a specified DragSourceContext , and coordinates of the cursor location. |
Modifier and Type | Method | Description |
---|---|---|
DragSourceContext |
getDragSourceContext() |
This method returns the DragSourceContext that originated the event. |
Point |
getLocation() |
This method returns a Point indicating the cursor location in screen coordinates at the moment this event occurred, or null if the cursor location is not specified for this event. |
int |
getX() |
This method returns the horizontal coordinate of the cursor location in screen coordinates at the moment this event occurred, or zero if the cursor location is not specified for this event. |
int |
getY() |
This method returns the vertical coordinate of the cursor location in screen coordinates at the moment this event occurred, or zero if the cursor location is not specified for this event. |
getSource, toString
public DragSourceEvent(DragSourceContext dsc)
DragSourceEvent
given a specified DragSourceContext
. The coordinates for this DragSourceEvent
are not specified, so getLocation
will return null
for this event.dsc
- the DragSourceContext
IllegalArgumentException
- if dsc
is null
.public DragSourceEvent(DragSourceContext dsc, int x, int y)
DragSourceEvent
given a specified DragSourceContext
, and coordinates of the cursor location.dsc
- the DragSourceContext
x
- the horizontal coordinate for the cursor locationy
- the vertical coordinate for the cursor locationIllegalArgumentException
- if dsc
is null
.public DragSourceContext getDragSourceContext()
DragSourceContext
that originated the event.DragSourceContext
that originated the eventpublic Point getLocation()
Point
indicating the cursor location in screen coordinates at the moment this event occurred, or null
if the cursor location is not specified for this event.Point
indicating the cursor location or null
if the cursor location is not specifiedpublic int getX()
public int getY()
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/dnd/DragSourceEvent.html