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
occured.
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 and Description |
---|
DragSourceEvent(DragSourceContext dsc)
Construct a
DragSourceEvent
given a specified DragSourceContext . |
DragSourceEvent(DragSourceContext dsc,
int x,
int y)
Construct a
DragSourceEvent given a specified
DragSourceContext , and coordinates of the cursor
___location. |
Modifier and Type | Method and 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 occured, 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 occured, 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 occured, 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
.getLocation()
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 occured, 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()
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, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.