< prev index next >

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

Print this page

        

*** 24,39 **** */ package java.awt.dnd; /** ! * The <code>DragSourceDropEvent</code> is delivered ! * from the <code>DragSourceContextPeer</code>, ! * via the <code>DragSourceContext</code>, to the <code>dragDropEnd</code> ! * method of <code>DragSourceListener</code>s registered with that ! * <code>DragSourceContext</code> and with its associated ! * <code>DragSource</code>. * It contains sufficient information for the * originator of the operation * to provide appropriate feedback to the end user * when the operation completes. * --- 24,39 ---- */ package java.awt.dnd; /** ! * The {@code DragSourceDropEvent} is delivered ! * from the {@code DragSourceContextPeer}, ! * via the {@code DragSourceContext}, to the {@code dragDropEnd} ! * method of {@code DragSourceListener}s registered with that ! * {@code DragSourceContext} and with its associated ! * {@code DragSource}. * It contains sufficient information for the * originator of the operation * to provide appropriate feedback to the end user * when the operation completes. *
*** 43,70 **** public class DragSourceDropEvent extends DragSourceEvent { private static final long serialVersionUID = -5571321229470821891L; /** ! * Construct a <code>DragSourceDropEvent</code> for a drop, * given the ! * <code>DragSourceContext</code>, the drop action, ! * and a <code>boolean</code> indicating if the drop was successful. ! * The coordinates for this <code>DragSourceDropEvent</code> ! * are not specified, so <code>getLocation</code> will return ! * <code>null</code> for this event. * <p> ! * The argument <code>action</code> should be one of <code>DnDConstants</code> * that represents a single action. ! * This constructor does not throw any exception for invalid <code>action</code>. * ! * @param dsc the <code>DragSourceContext</code> ! * associated with this <code>DragSourceDropEvent</code> * @param action the drop action * @param success a boolean indicating if the drop was successful * ! * @throws IllegalArgumentException if <code>dsc</code> is <code>null</code>. * * @see DragSourceEvent#getLocation */ public DragSourceDropEvent(DragSourceContext dsc, int action, boolean success) { --- 43,70 ---- public class DragSourceDropEvent extends DragSourceEvent { private static final long serialVersionUID = -5571321229470821891L; /** ! * Construct a {@code DragSourceDropEvent} for a drop, * given the ! * {@code DragSourceContext}, the drop action, ! * and a {@code boolean} indicating if the drop was successful. ! * The coordinates for this {@code DragSourceDropEvent} ! * are not specified, so {@code getLocation} will return ! * {@code null} for this event. * <p> ! * The argument {@code action} should be one of {@code DnDConstants} * that represents a single action. ! * This constructor does not throw any exception for invalid {@code action}. * ! * @param dsc the {@code DragSourceContext} ! * associated with this {@code DragSourceDropEvent} * @param action the drop action * @param success a boolean indicating if the drop was successful * ! * @throws IllegalArgumentException if {@code dsc} is {@code null}. * * @see DragSourceEvent#getLocation */ public DragSourceDropEvent(DragSourceContext dsc, int action, boolean success) {
*** 73,98 **** dropSuccess = success; dropAction = action; } /** ! * Construct a <code>DragSourceDropEvent</code> for a drop, given the ! * <code>DragSourceContext</code>, the drop action, a <code>boolean</code> * indicating if the drop was successful, and coordinates. * <p> ! * The argument <code>action</code> should be one of <code>DnDConstants</code> * that represents a single action. ! * This constructor does not throw any exception for invalid <code>action</code>. * ! * @param dsc the <code>DragSourceContext</code> ! * associated with this <code>DragSourceDropEvent</code> * @param action the drop action * @param success a boolean indicating if the drop was successful * @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 DragSourceDropEvent(DragSourceContext dsc, int action, boolean success, int x, int y) { --- 73,98 ---- dropSuccess = success; dropAction = action; } /** ! * Construct a {@code DragSourceDropEvent} for a drop, given the ! * {@code DragSourceContext}, the drop action, a {@code boolean} * indicating if the drop was successful, and coordinates. * <p> ! * The argument {@code action} should be one of {@code DnDConstants} * that represents a single action. ! * This constructor does not throw any exception for invalid {@code action}. * ! * @param dsc the {@code DragSourceContext} ! * associated with this {@code DragSourceDropEvent} * @param action the drop action * @param success a boolean indicating if the drop was successful * @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 DragSourceDropEvent(DragSourceContext dsc, int action, boolean success, int x, int y) {
*** 101,119 **** dropSuccess = success; dropAction = action; } /** ! * Construct a <code>DragSourceDropEvent</code> * for a drag that does not result in a drop. ! * The coordinates for this <code>DragSourceDropEvent</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 DragSourceEvent#getLocation */ public DragSourceDropEvent(DragSourceContext dsc) { --- 101,119 ---- dropSuccess = success; dropAction = action; } /** ! * Construct a {@code DragSourceDropEvent} * for a drag that does not result in a drop. ! * The coordinates for this {@code DragSourceDropEvent} ! * 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 DragSourceEvent#getLocation */ public DragSourceDropEvent(DragSourceContext dsc) {
*** 121,160 **** dropSuccess = false; } /** ! * This method returns a <code>boolean</code> indicating * if the drop was successful. * ! * @return <code>true</code> if the drop target accepted the drop and * successfully performed a drop action; ! * <code>false</code> if the drop target rejected the drop or * if the drop target accepted the drop, but failed to perform * a drop action. */ public boolean getDropSuccess() { return dropSuccess; } /** ! * This method returns an <code>int</code> representing * the action performed by the target on the subject of the drop. * * @return the action performed by the target on the subject of the drop * if the drop target accepted the drop and the target drop action * is supported by the drag source; otherwise, ! * <code>DnDConstants.ACTION_NONE</code>. */ public int getDropAction() { return dropAction; } /* * fields */ /** ! * <code>true</code> if the drop was successful. * * @serial */ private boolean dropSuccess; --- 121,160 ---- dropSuccess = false; } /** ! * This method returns a {@code boolean} indicating * if the drop was successful. * ! * @return {@code true} if the drop target accepted the drop and * successfully performed a drop action; ! * {@code false} if the drop target rejected the drop or * if the drop target accepted the drop, but failed to perform * a drop action. */ public boolean getDropSuccess() { return dropSuccess; } /** ! * This method returns an {@code int} representing * the action performed by the target on the subject of the drop. * * @return the action performed by the target on the subject of the drop * if the drop target accepted the drop and the target drop action * is supported by the drag source; otherwise, ! * {@code DnDConstants.ACTION_NONE}. */ public int getDropAction() { return dropAction; } /* * fields */ /** ! * {@code true} if the drop was successful. * * @serial */ private boolean dropSuccess;
< prev index next >