1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151
/* * @(#)DragSourceDropEvent.java 1.20 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ 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. * <P> * @version 1.20, 11/17/05 * <P> * @since 1.2 */ 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 <code>IllegalArgumentException</code> if <code>dsc</code> is <code>null</code>. * * @see DragSourceEvent#getLocation */ public DragSourceDropEvent(DragSourceContext dsc, int action, boolean success) { super(dsc); 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 <code>IllegalArgumentException</code> if <code>dsc</code> is <code>null</code>. * * @since 1.4 */ public DragSourceDropEvent(DragSourceContext dsc, int action, boolean success, int x, int y) { super(dsc, x, y); 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 <code>IllegalArgumentException</code> if <code>dsc</code> is <code>null</code>. * * @see DragSourceEvent#getLocation */ public DragSourceDropEvent(DragSourceContext dsc) { super(dsc); 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; /** * The drop action. * * @serial */ private int dropAction = DnDConstants.ACTION_NONE; }