< prev index next >

src/java.desktop/share/classes/java/awt/dnd/DragSourceEvent.java

Print this page

        

*** 29,55 **** import java.util.EventObject; /** * This class is the base class for ! * <code>DragSourceDragEvent</code> and ! * <code>DragSourceDropEvent</code>. * <p> ! * <code>DragSourceEvent</code>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 <code>DragSourceEvent</code> specifies * the mouse cursor location in screen coordinates at the moment this event * occurred. * <p> * In a multi-screen environment without a virtual device, the cursor location is * specified in the coordinate system of the <i>initiator</i> ! * <code>GraphicsConfiguration</code>. The <i>initiator</i> ! * <code>GraphicsConfiguration</code> is the <code>GraphicsConfiguration</code> ! * of the <code>Component</code> on which the drag gesture for the current drag * operation was recognized. If the cursor location is outside the bounds of ! * the initiator <code>GraphicsConfiguration</code>, the reported coordinates are ! * clipped to fit within the bounds of that <code>GraphicsConfiguration</code>. * <p> * 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. --- 29,55 ---- import java.util.EventObject; /** * This class is the base class for ! * {@code DragSourceDragEvent} and ! * {@code DragSourceDropEvent}. * <p> ! * {@code 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 {@code DragSourceEvent} specifies * the mouse cursor location in screen coordinates at the moment this event * occurred. * <p> * In a multi-screen environment without a virtual device, the cursor location is * specified in the coordinate system of the <i>initiator</i> ! * {@code GraphicsConfiguration}. The <i>initiator</i> ! * {@code GraphicsConfiguration} is the {@code GraphicsConfiguration} ! * of the {@code Component} on which the drag gesture for the current drag * operation was recognized. If the cursor location is outside the bounds of ! * the initiator {@code GraphicsConfiguration}, the reported coordinates are ! * clipped to fit within the bounds of that {@code GraphicsConfiguration}. * <p> * 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.
*** 60,70 **** public class DragSourceEvent extends EventObject { private static final long serialVersionUID = -763287114604032641L; /** ! * The <code>boolean</code> indicating whether the cursor location * is specified for this event. * * @serial */ private final boolean locationSpecified; --- 60,70 ---- public class DragSourceEvent extends EventObject { private static final long serialVersionUID = -763287114604032641L; /** ! * The {@code boolean} indicating whether the cursor location * is specified for this event. * * @serial */ private final boolean locationSpecified;
*** 86,104 **** * @serial */ private final int y; /** ! * Construct a <code>DragSourceEvent</code> ! * given a specified <code>DragSourceContext</code>. ! * The coordinates for this <code>DragSourceEvent</code> ! * are not specified, so <code>getLocation</code> will return ! * <code>null</code> for this event. * ! * @param dsc the <code>DragSourceContext</code> * ! * @throws IllegalArgumentException if <code>dsc</code> is <code>null</code>. * * @see #getLocation */ public DragSourceEvent(DragSourceContext dsc) { --- 86,104 ---- * @serial */ private final int y; /** ! * Construct a {@code DragSourceEvent} ! * given a specified {@code DragSourceContext}. ! * The coordinates for this {@code DragSourceEvent} ! * are not specified, so {@code getLocation} will return ! * {@code null} for this event. * ! * @param dsc the {@code DragSourceContext} * ! * @throws IllegalArgumentException if {@code dsc} is {@code null}. * * @see #getLocation */ public DragSourceEvent(DragSourceContext dsc) {
*** 107,125 **** this.x = 0; this.y = 0; } /** ! * Construct a <code>DragSourceEvent</code> given a specified ! * <code>DragSourceContext</code>, and coordinates of the cursor * location. * ! * @param dsc the <code>DragSourceContext</code> * @param x the horizontal coordinate for the cursor location * @param y the vertical coordinate for the cursor location * ! * @throws IllegalArgumentException if <code>dsc</code> is <code>null</code>. * * @since 1.4 */ public DragSourceEvent(DragSourceContext dsc, int x, int y) { super(dsc); --- 107,125 ---- this.x = 0; this.y = 0; } /** ! * Construct a {@code DragSourceEvent} given a specified ! * {@code DragSourceContext}, and coordinates of the cursor * location. * ! * @param dsc the {@code DragSourceContext} * @param x the horizontal coordinate for the cursor location * @param y the vertical coordinate for the cursor location * ! * @throws IllegalArgumentException if {@code dsc} is {@code null}. * * @since 1.4 */ public DragSourceEvent(DragSourceContext dsc, int x, int y) { super(dsc);
*** 127,154 **** this.x = x; this.y = y; } /** ! * This method returns the <code>DragSourceContext</code> that * originated the event. * ! * @return the <code>DragSourceContext</code> that originated the event */ public DragSourceContext getDragSourceContext() { return (DragSourceContext)getSource(); } /** ! * This method returns a <code>Point</code> indicating the cursor * location in screen coordinates at the moment this event occurred, or ! * <code>null</code> if the cursor location is not specified for this * event. * ! * @return the <code>Point</code> indicating the cursor location ! * or <code>null</code> if the cursor location is not specified * @since 1.4 */ public Point getLocation() { if (locationSpecified) { return new Point(x, y); --- 127,154 ---- this.x = x; this.y = y; } /** ! * This method returns the {@code DragSourceContext} that * originated the event. * ! * @return the {@code DragSourceContext} that originated the event */ public DragSourceContext getDragSourceContext() { return (DragSourceContext)getSource(); } /** ! * This method returns a {@code Point} indicating the cursor * location in screen coordinates at the moment this event occurred, or ! * {@code null} if the cursor location is not specified for this * event. * ! * @return the {@code Point} indicating the cursor location ! * or {@code null} if the cursor location is not specified * @since 1.4 */ public Point getLocation() { if (locationSpecified) { return new Point(x, y);
< prev index next >