< prev index next >
src/java.desktop/share/classes/java/awt/dnd/DragSource.java
Print this page
@@ -47,61 +47,61 @@
import sun.awt.dnd.SunDragSourceContextPeer;
import sun.security.action.GetIntegerAction;
/**
- * The <code>DragSource</code> is the entity responsible
+ * The {@code DragSource} is the entity responsible
* for the initiation of the Drag
* and Drop operation, and may be used in a number of scenarios:
* <UL>
* <LI>1 default instance per JVM for the lifetime of that JVM.
* <LI>1 instance per class of potential Drag Initiator object (e.g
* TextField). [implementation dependent]
* <LI>1 per instance of a particular
- * <code>Component</code>, or application specific
- * object associated with a <code>Component</code>
+ * {@code Component}, or application specific
+ * object associated with a {@code Component}
* instance in the GUI. [implementation dependent]
* <LI>Some other arbitrary association. [implementation dependent]
*</UL>
*
- * Once the <code>DragSource</code> is
- * obtained, a <code>DragGestureRecognizer</code> should
- * also be obtained to associate the <code>DragSource</code>
+ * Once the {@code DragSource} is
+ * obtained, a {@code DragGestureRecognizer} should
+ * also be obtained to associate the {@code DragSource}
* with a particular
- * <code>Component</code>.
+ * {@code Component}.
* <P>
* The initial interpretation of the user's gesture,
* and the subsequent starting of the drag operation
* are the responsibility of the implementing
- * <code>Component</code>, which is usually
- * implemented by a <code>DragGestureRecognizer</code>.
+ * {@code Component}, which is usually
+ * implemented by a {@code DragGestureRecognizer}.
*<P>
* When a drag gesture occurs, the
- * <code>DragSource</code>'s
+ * {@code DragSource}'s
* startDrag() method shall be
* invoked in order to cause processing
* of the user's navigational
* gestures and delivery of Drag and Drop
* protocol notifications. A
- * <code>DragSource</code> shall only
+ * {@code DragSource} shall only
* permit a single Drag and Drop operation to be
* current at any one time, and shall
* reject any further startDrag() requests
- * by throwing an <code>IllegalDnDOperationException</code>
+ * by throwing an {@code IllegalDnDOperationException}
* until such time as the extant operation is complete.
* <P>
* The startDrag() method invokes the
* createDragSourceContext() method to
* instantiate an appropriate
- * <code>DragSourceContext</code>
- * and associate the <code>DragSourceContextPeer</code>
+ * {@code DragSourceContext}
+ * and associate the {@code DragSourceContextPeer}
* with that.
* <P>
* If the Drag and Drop System is
* unable to initiate a drag operation for
* some reason, the startDrag() method throws
- * a <code>java.awt.dnd.InvalidDnDOperationException</code>
+ * a {@code java.awt.dnd.InvalidDnDOperationException}
* to signal such a condition. Typically this
* exception is thrown when the underlying platform
* system is either not in a state to
* initiate a drag, or the parameters specified are invalid.
* <P>
@@ -109,11 +109,11 @@
* set of operations exposed by the source
* at the start of the drag operation may not change
* until the operation is complete.
* The operation(s) are constant for the
* duration of the operation with respect to the
- * <code>DragSource</code>.
+ * {@code DragSource}.
*
* @since 1.2
*/
public class DragSource implements Serializable {
@@ -138,63 +138,63 @@
}
}
/**
- * The default <code>Cursor</code> to use with a copy operation indicating
- * that a drop is currently allowed. <code>null</code> if
- * <code>GraphicsEnvironment.isHeadless()</code> returns <code>true</code>.
+ * The default {@code Cursor} to use with a copy operation indicating
+ * that a drop is currently allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public static final Cursor DefaultCopyDrop =
load("DnD.Cursor.CopyDrop");
/**
- * The default <code>Cursor</code> to use with a move operation indicating
- * that a drop is currently allowed. <code>null</code> if
- * <code>GraphicsEnvironment.isHeadless()</code> returns <code>true</code>.
+ * The default {@code Cursor} to use with a move operation indicating
+ * that a drop is currently allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public static final Cursor DefaultMoveDrop =
load("DnD.Cursor.MoveDrop");
/**
- * The default <code>Cursor</code> to use with a link operation indicating
- * that a drop is currently allowed. <code>null</code> if
- * <code>GraphicsEnvironment.isHeadless()</code> returns <code>true</code>.
+ * The default {@code Cursor} to use with a link operation indicating
+ * that a drop is currently allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public static final Cursor DefaultLinkDrop =
load("DnD.Cursor.LinkDrop");
/**
- * The default <code>Cursor</code> to use with a copy operation indicating
- * that a drop is currently not allowed. <code>null</code> if
- * <code>GraphicsEnvironment.isHeadless()</code> returns <code>true</code>.
+ * The default {@code Cursor} to use with a copy operation indicating
+ * that a drop is currently not allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public static final Cursor DefaultCopyNoDrop =
load("DnD.Cursor.CopyNoDrop");
/**
- * The default <code>Cursor</code> to use with a move operation indicating
- * that a drop is currently not allowed. <code>null</code> if
- * <code>GraphicsEnvironment.isHeadless()</code> returns <code>true</code>.
+ * The default {@code Cursor} to use with a move operation indicating
+ * that a drop is currently not allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public static final Cursor DefaultMoveNoDrop =
load("DnD.Cursor.MoveNoDrop");
/**
- * The default <code>Cursor</code> to use with a link operation indicating
- * that a drop is currently not allowed. <code>null</code> if
- * <code>GraphicsEnvironment.isHeadless()</code> returns <code>true</code>.
+ * The default {@code Cursor} to use with a link operation indicating
+ * that a drop is currently not allowed. {@code null} if
+ * {@code GraphicsEnvironment.isHeadless()} returns {@code true}.
*
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public static final Cursor DefaultLinkNoDrop =
load("DnD.Cursor.LinkNoDrop");
@@ -207,11 +207,11 @@
*/
static final String dragSourceListenerK = "dragSourceL";
static final String dragSourceMotionListenerK = "dragSourceMotionL";
/**
- * Gets the <code>DragSource</code> object associated with
+ * Gets the {@code DragSource} object associated with
* the underlying platform.
*
* @return the platform DragSource
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
@@ -226,11 +226,11 @@
}
/**
* Reports
* whether or not drag
- * <code>Image</code> support
+ * {@code Image} support
* is available on the underlying platform.
*
* @return if the Drag Image support is available on this platform
*/
@@ -247,11 +247,11 @@
return false;
}
}
/**
- * Creates a new <code>DragSource</code>.
+ * Creates a new {@code DragSource}.
*
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
*/
@@ -260,32 +260,32 @@
throw new HeadlessException();
}
}
/**
- * Start a drag, given the <code>DragGestureEvent</code>
+ * Start a drag, given the {@code DragGestureEvent}
* that initiated the drag, the initial
- * <code>Cursor</code> to use,
- * the <code>Image</code> to drag,
- * the offset of the <code>Image</code> origin
- * from the hotspot of the <code>Cursor</code> at
+ * {@code Cursor} to use,
+ * the {@code Image} to drag,
+ * the offset of the {@code Image} origin
+ * from the hotspot of the {@code Cursor} at
* the instant of the trigger,
- * the <code>Transferable</code> subject data
- * of the drag, the <code>DragSourceListener</code>,
- * and the <code>FlavorMap</code>.
+ * the {@code Transferable} subject data
+ * of the drag, the {@code DragSourceListener},
+ * and the {@code FlavorMap}.
*
- * @param trigger the <code>DragGestureEvent</code> that initiated the drag
+ * @param trigger the {@code DragGestureEvent} that initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see <a href="DragSourceContext.html#defaultCursor">DragSourceContext</a>
* for more details on the cursor handling mechanism during drag and drop
* @param dragImage the image to drag or {@code null}
- * @param imageOffset the offset of the <code>Image</code> origin from the hotspot
- * of the <code>Cursor</code> at the instant of the trigger
+ * @param imageOffset the offset of the {@code Image} origin from the hotspot
+ * of the {@code Cursor} at the instant of the trigger
* @param transferable the subject data of the drag
- * @param dsl the <code>DragSourceListener</code>
- * @param flavorMap the <code>FlavorMap</code> to use, or <code>null</code>
+ * @param dsl the {@code DragSourceListener}
+ * @param flavorMap the {@code FlavorMap} to use, or {@code null}
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
* system is unable to initiate a drag operation, or if the user
* attempts to start a drag while an existing drag operation
@@ -320,26 +320,26 @@
throw e;
}
}
/**
- * Start a drag, given the <code>DragGestureEvent</code>
+ * Start a drag, given the {@code DragGestureEvent}
* that initiated the drag, the initial
- * <code>Cursor</code> to use,
- * the <code>Transferable</code> subject data
- * of the drag, the <code>DragSourceListener</code>,
- * and the <code>FlavorMap</code>.
+ * {@code Cursor} to use,
+ * the {@code Transferable} subject data
+ * of the drag, the {@code DragSourceListener},
+ * and the {@code FlavorMap}.
*
- * @param trigger the <code>DragGestureEvent</code> that
+ * @param trigger the {@code DragGestureEvent} that
* initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see <a href="DragSourceContext.html#defaultCursor">DragSourceContext</a>
* for more details on the cursor handling mechanism during drag and drop
* @param transferable the subject data of the drag
- * @param dsl the <code>DragSourceListener</code>
- * @param flavorMap the <code>FlavorMap</code> to use or <code>null</code>
+ * @param dsl the {@code DragSourceListener}
+ * @param flavorMap the {@code FlavorMap} to use or {@code null}
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
* system is unable to initiate a drag operation, or if the user
* attempts to start a drag while an existing drag operation
@@ -353,30 +353,30 @@
FlavorMap flavorMap) throws InvalidDnDOperationException {
startDrag(trigger, dragCursor, null, null, transferable, dsl, flavorMap);
}
/**
- * Start a drag, given the <code>DragGestureEvent</code>
- * that initiated the drag, the initial <code>Cursor</code>
+ * Start a drag, given the {@code DragGestureEvent}
+ * that initiated the drag, the initial {@code Cursor}
* to use,
- * the <code>Image</code> to drag,
- * the offset of the <code>Image</code> origin
- * from the hotspot of the <code>Cursor</code>
+ * the {@code Image} to drag,
+ * the offset of the {@code Image} origin
+ * from the hotspot of the {@code Cursor}
* at the instant of the trigger,
* the subject data of the drag, and
- * the <code>DragSourceListener</code>.
+ * the {@code DragSourceListener}.
*
- * @param trigger the <code>DragGestureEvent</code> that initiated the drag
+ * @param trigger the {@code DragGestureEvent} that initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see <a href="DragSourceContext.html#defaultCursor">DragSourceContext</a>
* for more details on the cursor handling mechanism during drag and drop
- * @param dragImage the <code>Image</code> to drag or <code>null</code>
- * @param dragOffset the offset of the <code>Image</code> origin from the hotspot
- * of the <code>Cursor</code> at the instant of the trigger
+ * @param dragImage the {@code Image} to drag or {@code null}
+ * @param dragOffset the offset of the {@code Image} origin from the hotspot
+ * of the {@code Cursor} at the instant of the trigger
* @param transferable the subject data of the drag
- * @param dsl the <code>DragSourceListener</code>
+ * @param dsl the {@code DragSourceListener}
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
* system is unable to initiate a drag operation, or if the user
* attempts to start a drag while an existing drag operation
@@ -391,24 +391,24 @@
DragSourceListener dsl) throws InvalidDnDOperationException {
startDrag(trigger, dragCursor, dragImage, dragOffset, transferable, dsl, null);
}
/**
- * Start a drag, given the <code>DragGestureEvent</code>
+ * Start a drag, given the {@code DragGestureEvent}
* that initiated the drag, the initial
- * <code>Cursor</code> to
+ * {@code Cursor} to
* use,
- * the <code>Transferable</code> subject data
- * of the drag, and the <code>DragSourceListener</code>.
+ * the {@code Transferable} subject data
+ * of the drag, and the {@code DragSourceListener}.
*
- * @param trigger the <code>DragGestureEvent</code> that initiated the drag
+ * @param trigger the {@code DragGestureEvent} that initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see <a href="DragSourceContext.html#defaultCursor">DragSourceContext</a> class
* for more details on the cursor handling mechanism during drag and drop
* @param transferable the subject data of the drag
- * @param dsl the <code>DragSourceListener</code>
+ * @param dsl the {@code DragSourceListener}
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
* system is unable to initiate a drag operation, or if the user
* attempts to start a drag while an existing drag operation
@@ -424,50 +424,50 @@
/**
* Creates the {@code DragSourceContext} to handle the current drag
* operation.
* <p>
- * To incorporate a new <code>DragSourceContext</code>
- * subclass, subclass <code>DragSource</code> and
+ * To incorporate a new {@code DragSourceContext}
+ * subclass, subclass {@code DragSource} and
* override this method.
* <p>
- * If <code>dragImage</code> is <code>null</code>, no image is used
+ * If {@code dragImage} is {@code null}, no image is used
* to represent the drag over feedback for this drag operation, but
- * <code>NullPointerException</code> is not thrown.
+ * {@code NullPointerException} is not thrown.
* <p>
- * If <code>dsl</code> is <code>null</code>, no drag source listener
- * is registered with the created <code>DragSourceContext</code>,
- * but <code>NullPointerException</code> is not thrown.
+ * If {@code dsl} is {@code null}, no drag source listener
+ * is registered with the created {@code DragSourceContext},
+ * but {@code NullPointerException} is not thrown.
*
- * @param dgl The <code>DragGestureEvent</code> that triggered the
+ * @param dgl The {@code DragGestureEvent} that triggered the
* drag
* @param dragCursor The initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see <a href="DragSourceContext.html#defaultCursor">DragSourceContext</a> class
* for more details on the cursor handling mechanism during drag and drop
- * @param dragImage The <code>Image</code> to drag or <code>null</code>
- * @param imageOffset The offset of the <code>Image</code> origin from the
+ * @param dragImage The {@code Image} to drag or {@code null}
+ * @param imageOffset The offset of the {@code Image} origin from the
* hotspot of the cursor at the instant of the trigger
* @param t The subject data of the drag
- * @param dsl The <code>DragSourceListener</code>
+ * @param dsl The {@code DragSourceListener}
*
- * @return the <code>DragSourceContext</code>
+ * @return the {@code DragSourceContext}
*
- * @throws NullPointerException if <code>dscp</code> is <code>null</code>
- * @throws NullPointerException if <code>dgl</code> is <code>null</code>
- * @throws NullPointerException if <code>dragImage</code> is not
- * <code>null</code> and <code>imageOffset</code> is <code>null</code>
- * @throws NullPointerException if <code>t</code> is <code>null</code>
- * @throws IllegalArgumentException if the <code>Component</code>
- * associated with the trigger event is <code>null</code>.
- * @throws IllegalArgumentException if the <code>DragSource</code> for the
- * trigger event is <code>null</code>.
+ * @throws NullPointerException if {@code dscp} is {@code null}
+ * @throws NullPointerException if {@code dgl} is {@code null}
+ * @throws NullPointerException if {@code dragImage} is not
+ * {@code null} and {@code imageOffset} is {@code null}
+ * @throws NullPointerException if {@code t} is {@code null}
+ * @throws IllegalArgumentException if the {@code Component}
+ * associated with the trigger event is {@code null}.
+ * @throws IllegalArgumentException if the {@code DragSource} for the
+ * trigger event is {@code null}.
* @throws IllegalArgumentException if the drag action for the
- * trigger event is <code>DnDConstants.ACTION_NONE</code>.
+ * trigger event is {@code DnDConstants.ACTION_NONE}.
* @throws IllegalArgumentException if the source actions for the
- * <code>DragGestureRecognizer</code> associated with the trigger
- * event are equal to <code>DnDConstants.ACTION_NONE</code>.
+ * {@code DragGestureRecognizer} associated with the trigger
+ * event are equal to {@code DnDConstants.ACTION_NONE}.
*/
protected DragSourceContext createDragSourceContext(DragGestureEvent dgl,
Cursor dragCursor,
Image dragImage,
@@ -477,37 +477,37 @@
return new DragSourceContext(dgl, dragCursor, dragImage, imageOffset, t, dsl);
}
/**
* This method returns the
- * <code>FlavorMap</code> for this <code>DragSource</code>.
+ * {@code FlavorMap} for this {@code DragSource}.
*
- * @return the <code>FlavorMap</code> for this <code>DragSource</code>
+ * @return the {@code FlavorMap} for this {@code DragSource}
*/
public FlavorMap getFlavorMap() { return flavorMap; }
/**
- * Creates a new <code>DragGestureRecognizer</code>
+ * Creates a new {@code DragGestureRecognizer}
* that implements the specified
* abstract subclass of
- * <code>DragGestureRecognizer</code>, and
- * sets the specified <code>Component</code>
- * and <code>DragGestureListener</code> on
+ * {@code DragGestureRecognizer}, and
+ * sets the specified {@code Component}
+ * and {@code DragGestureListener} on
* the newly created object.
*
* @param <T> the type of {@code DragGestureRecognizer} to create
* @param recognizerAbstractClass the requested abstract type
* @param actions the permitted source drag actions
- * @param c the <code>Component</code> target
- * @param dgl the <code>DragGestureListener</code> to notify
+ * @param c the {@code Component} target
+ * @param dgl the {@code DragGestureListener} to notify
*
- * @return the new <code>DragGestureRecognizer</code> or <code>null</code>
- * if the <code>Toolkit.createDragGestureRecognizer</code> method
+ * @return the new {@code DragGestureRecognizer} or {@code null}
+ * if the {@code Toolkit.createDragGestureRecognizer} method
* has no implementation available for
- * the requested <code>DragGestureRecognizer</code>
- * subclass and returns <code>null</code>
+ * the requested {@code DragGestureRecognizer}
+ * subclass and returns {@code null}
*/
public <T extends DragGestureRecognizer> T
createDragGestureRecognizer(Class<T> recognizerAbstractClass,
Component c, int actions,
@@ -516,44 +516,44 @@
return Toolkit.getDefaultToolkit().createDragGestureRecognizer(recognizerAbstractClass, this, c, actions, dgl);
}
/**
- * Creates a new <code>DragGestureRecognizer</code>
+ * Creates a new {@code DragGestureRecognizer}
* that implements the default
- * abstract subclass of <code>DragGestureRecognizer</code>
- * for this <code>DragSource</code>,
- * and sets the specified <code>Component</code>
- * and <code>DragGestureListener</code> on the
+ * abstract subclass of {@code DragGestureRecognizer}
+ * for this {@code DragSource},
+ * and sets the specified {@code Component}
+ * and {@code DragGestureListener} on the
* newly created object.
*
- * For this <code>DragSource</code>
- * the default is <code>MouseDragGestureRecognizer</code>.
+ * For this {@code DragSource}
+ * the default is {@code MouseDragGestureRecognizer}.
*
- * @param c the <code>Component</code> target for the recognizer
+ * @param c the {@code Component} target for the recognizer
* @param actions the permitted source actions
- * @param dgl the <code>DragGestureListener</code> to notify
+ * @param dgl the {@code DragGestureListener} to notify
*
- * @return the new <code>DragGestureRecognizer</code> or <code>null</code>
- * if the <code>Toolkit.createDragGestureRecognizer</code> method
+ * @return the new {@code DragGestureRecognizer} or {@code null}
+ * if the {@code Toolkit.createDragGestureRecognizer} method
* has no implementation available for
- * the requested <code>DragGestureRecognizer</code>
- * subclass and returns <code>null</code>
+ * the requested {@code DragGestureRecognizer}
+ * subclass and returns {@code null}
*/
public DragGestureRecognizer createDefaultDragGestureRecognizer(Component c, int actions, DragGestureListener dgl) {
return Toolkit.getDefaultToolkit().createDragGestureRecognizer(MouseDragGestureRecognizer.class, this, c, actions, dgl);
}
/**
- * Adds the specified <code>DragSourceListener</code> to this
- * <code>DragSource</code> to receive drag source events during drag
- * operations initiated with this <code>DragSource</code>.
- * If a <code>null</code> listener is specified, no action is taken and no
+ * Adds the specified {@code DragSourceListener} to this
+ * {@code DragSource} to receive drag source events during drag
+ * operations initiated with this {@code DragSource}.
+ * If a {@code null} listener is specified, no action is taken and no
* exception is thrown.
*
- * @param dsl the <code>DragSourceListener</code> to add
+ * @param dsl the {@code DragSourceListener} to add
*
* @see #removeDragSourceListener
* @see #getDragSourceListeners
* @since 1.4
*/
@@ -564,19 +564,19 @@
}
}
}
/**
- * Removes the specified <code>DragSourceListener</code> from this
- * <code>DragSource</code>.
- * If a <code>null</code> listener is specified, no action is taken and no
+ * Removes the specified {@code DragSourceListener} from this
+ * {@code DragSource}.
+ * If a {@code null} listener is specified, no action is taken and no
* exception is thrown.
* If the listener specified by the argument was not previously added to
- * this <code>DragSource</code>, no action is taken and no exception
+ * this {@code DragSource}, no action is taken and no exception
* is thrown.
*
- * @param dsl the <code>DragSourceListener</code> to remove
+ * @param dsl the {@code DragSourceListener} to remove
*
* @see #addDragSourceListener
* @see #getDragSourceListeners
* @since 1.4
*/
@@ -587,15 +587,15 @@
}
}
}
/**
- * Gets all the <code>DragSourceListener</code>s
- * registered with this <code>DragSource</code>.
+ * Gets all the {@code DragSourceListener}s
+ * registered with this {@code DragSource}.
*
- * @return all of this <code>DragSource</code>'s
- * <code>DragSourceListener</code>s or an empty array if no
+ * @return all of this {@code DragSource}'s
+ * {@code DragSourceListener}s or an empty array if no
* such listeners are currently registered
*
* @see #addDragSourceListener
* @see #removeDragSourceListener
* @since 1.4
@@ -603,17 +603,17 @@
public DragSourceListener[] getDragSourceListeners() {
return getListeners(DragSourceListener.class);
}
/**
- * Adds the specified <code>DragSourceMotionListener</code> to this
- * <code>DragSource</code> to receive drag motion events during drag
- * operations initiated with this <code>DragSource</code>.
- * If a <code>null</code> listener is specified, no action is taken and no
+ * Adds the specified {@code DragSourceMotionListener} to this
+ * {@code DragSource} to receive drag motion events during drag
+ * operations initiated with this {@code DragSource}.
+ * If a {@code null} listener is specified, no action is taken and no
* exception is thrown.
*
- * @param dsml the <code>DragSourceMotionListener</code> to add
+ * @param dsml the {@code DragSourceMotionListener} to add
*
* @see #removeDragSourceMotionListener
* @see #getDragSourceMotionListeners
* @since 1.4
*/
@@ -624,19 +624,19 @@
}
}
}
/**
- * Removes the specified <code>DragSourceMotionListener</code> from this
- * <code>DragSource</code>.
- * If a <code>null</code> listener is specified, no action is taken and no
+ * Removes the specified {@code DragSourceMotionListener} from this
+ * {@code DragSource}.
+ * If a {@code null} listener is specified, no action is taken and no
* exception is thrown.
* If the listener specified by the argument was not previously added to
- * this <code>DragSource</code>, no action is taken and no exception
+ * this {@code DragSource}, no action is taken and no exception
* is thrown.
*
- * @param dsml the <code>DragSourceMotionListener</code> to remove
+ * @param dsml the {@code DragSourceMotionListener} to remove
*
* @see #addDragSourceMotionListener
* @see #getDragSourceMotionListeners
* @since 1.4
*/
@@ -647,15 +647,15 @@
}
}
}
/**
- * Gets all of the <code>DragSourceMotionListener</code>s
- * registered with this <code>DragSource</code>.
+ * Gets all of the {@code DragSourceMotionListener}s
+ * registered with this {@code DragSource}.
*
- * @return all of this <code>DragSource</code>'s
- * <code>DragSourceMotionListener</code>s or an empty array if no
+ * @return all of this {@code DragSource}'s
+ * {@code DragSourceMotionListener}s or an empty array if no
* such listeners are currently registered
*
* @see #addDragSourceMotionListener
* @see #removeDragSourceMotionListener
* @since 1.4
@@ -664,25 +664,25 @@
return getListeners(DragSourceMotionListener.class);
}
/**
* Gets all the objects currently registered as
- * <code><em>Foo</em>Listener</code>s upon this <code>DragSource</code>.
+ * <code><em>Foo</em>Listener</code>s upon this {@code DragSource}.
* <code><em>Foo</em>Listener</code>s are registered using the
* <code>add<em>Foo</em>Listener</code> method.
*
* @param <T> the type of listener objects
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * <code>java.util.EventListener</code>
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* <code><em>Foo</em>Listener</code>s on this
- * <code>DragSource</code>, or an empty array if no such listeners
+ * {@code DragSource}, or an empty array if no such listeners
* have been added
- * @exception ClassCastException if <code>listenerType</code>
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * <code>java.util.EventListener</code>
+ * {@code java.util.EventListener}
*
* @see #getDragSourceListeners
* @see #getDragSourceMotionListeners
* @since 1.4
*/
@@ -695,127 +695,127 @@
}
return DnDEventMulticaster.getListeners(l, listenerType);
}
/**
- * This method calls <code>dragEnter</code> on the
- * <code>DragSourceListener</code>s registered with this
- * <code>DragSource</code>, and passes them the specified
- * <code>DragSourceDragEvent</code>.
+ * This method calls {@code dragEnter} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the <code>DragSourceDragEvent</code>
+ * @param dsde the {@code DragSourceDragEvent}
*/
void processDragEnter(DragSourceDragEvent dsde) {
DragSourceListener dsl = listener;
if (dsl != null) {
dsl.dragEnter(dsde);
}
}
/**
- * This method calls <code>dragOver</code> on the
- * <code>DragSourceListener</code>s registered with this
- * <code>DragSource</code>, and passes them the specified
- * <code>DragSourceDragEvent</code>.
+ * This method calls {@code dragOver} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the <code>DragSourceDragEvent</code>
+ * @param dsde the {@code DragSourceDragEvent}
*/
void processDragOver(DragSourceDragEvent dsde) {
DragSourceListener dsl = listener;
if (dsl != null) {
dsl.dragOver(dsde);
}
}
/**
- * This method calls <code>dropActionChanged</code> on the
- * <code>DragSourceListener</code>s registered with this
- * <code>DragSource</code>, and passes them the specified
- * <code>DragSourceDragEvent</code>.
+ * This method calls {@code dropActionChanged} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the <code>DragSourceDragEvent</code>
+ * @param dsde the {@code DragSourceDragEvent}
*/
void processDropActionChanged(DragSourceDragEvent dsde) {
DragSourceListener dsl = listener;
if (dsl != null) {
dsl.dropActionChanged(dsde);
}
}
/**
- * This method calls <code>dragExit</code> on the
- * <code>DragSourceListener</code>s registered with this
- * <code>DragSource</code>, and passes them the specified
- * <code>DragSourceEvent</code>.
+ * This method calls {@code dragExit} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceEvent}.
*
- * @param dse the <code>DragSourceEvent</code>
+ * @param dse the {@code DragSourceEvent}
*/
void processDragExit(DragSourceEvent dse) {
DragSourceListener dsl = listener;
if (dsl != null) {
dsl.dragExit(dse);
}
}
/**
- * This method calls <code>dragDropEnd</code> on the
- * <code>DragSourceListener</code>s registered with this
- * <code>DragSource</code>, and passes them the specified
- * <code>DragSourceDropEvent</code>.
+ * This method calls {@code dragDropEnd} on the
+ * {@code DragSourceListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDropEvent}.
*
- * @param dsde the <code>DragSourceEvent</code>
+ * @param dsde the {@code DragSourceEvent}
*/
void processDragDropEnd(DragSourceDropEvent dsde) {
DragSourceListener dsl = listener;
if (dsl != null) {
dsl.dragDropEnd(dsde);
}
}
/**
- * This method calls <code>dragMouseMoved</code> on the
- * <code>DragSourceMotionListener</code>s registered with this
- * <code>DragSource</code>, and passes them the specified
- * <code>DragSourceDragEvent</code>.
+ * This method calls {@code dragMouseMoved} on the
+ * {@code DragSourceMotionListener}s registered with this
+ * {@code DragSource}, and passes them the specified
+ * {@code DragSourceDragEvent}.
*
- * @param dsde the <code>DragSourceEvent</code>
+ * @param dsde the {@code DragSourceEvent}
*/
void processDragMouseMoved(DragSourceDragEvent dsde) {
DragSourceMotionListener dsml = motionListener;
if (dsml != null) {
dsml.dragMouseMoved(dsde);
}
}
/**
- * Serializes this <code>DragSource</code>. This method first performs
+ * Serializes this {@code DragSource}. This method first performs
* default serialization. Next, it writes out this object's
- * <code>FlavorMap</code> if and only if it can be serialized. If not,
- * <code>null</code> is written instead. Next, it writes out
- * <code>Serializable</code> listeners registered with this
- * object. Listeners are written in a <code>null</code>-terminated sequence
- * of 0 or more pairs. The pair consists of a <code>String</code> and an
- * <code>Object</code>; the <code>String</code> indicates the type of the
- * <code>Object</code> and is one of the following:
+ * {@code FlavorMap} if and only if it can be serialized. If not,
+ * {@code null} is written instead. Next, it writes out
+ * {@code Serializable} listeners registered with this
+ * object. Listeners are written in a {@code null}-terminated sequence
+ * of 0 or more pairs. The pair consists of a {@code String} and an
+ * {@code Object}; the {@code String} indicates the type of the
+ * {@code Object} and is one of the following:
* <ul>
- * <li><code>dragSourceListenerK</code> indicating a
- * <code>DragSourceListener</code> object;
- * <li><code>dragSourceMotionListenerK</code> indicating a
- * <code>DragSourceMotionListener</code> object.
+ * <li>{@code dragSourceListenerK} indicating a
+ * {@code DragSourceListener} object;
+ * <li>{@code dragSourceMotionListenerK} indicating a
+ * {@code DragSourceMotionListener} object.
* </ul>
*
- * @serialData Either a <code>FlavorMap</code> instance, or
- * <code>null</code>, followed by a <code>null</code>-terminated
+ * @serialData Either a {@code FlavorMap} instance, or
+ * {@code null}, followed by a {@code null}-terminated
* sequence of 0 or more pairs; the pair consists of a
- * <code>String</code> and an <code>Object</code>; the
- * <code>String</code> indicates the type of the <code>Object</code>
+ * {@code String} and an {@code Object}; the
+ * {@code String} indicates the type of the {@code Object}
* and is one of the following:
* <ul>
- * <li><code>dragSourceListenerK</code> indicating a
- * <code>DragSourceListener</code> object;
- * <li><code>dragSourceMotionListenerK</code> indicating a
- * <code>DragSourceMotionListener</code> object.
+ * <li>{@code dragSourceListenerK} indicating a
+ * {@code DragSourceListener} object;
+ * <li>{@code dragSourceMotionListenerK} indicating a
+ * {@code DragSourceMotionListener} object.
* </ul>.
* @since 1.4
*/
private void writeObject(ObjectOutputStream s) throws IOException {
s.defaultWriteObject();
@@ -826,28 +826,28 @@
DnDEventMulticaster.save(s, dragSourceMotionListenerK, motionListener);
s.writeObject(null);
}
/**
- * Deserializes this <code>DragSource</code>. This method first performs
- * default deserialization. Next, this object's <code>FlavorMap</code> is
+ * Deserializes this {@code DragSource}. This method first performs
+ * default deserialization. Next, this object's {@code FlavorMap} is
* deserialized by using the next object in the stream.
- * If the resulting <code>FlavorMap</code> is <code>null</code>, this
- * object's <code>FlavorMap</code> is set to the default FlavorMap for
- * this thread's <code>ClassLoader</code>.
+ * If the resulting {@code FlavorMap} is {@code null}, this
+ * object's {@code FlavorMap} is set to the default FlavorMap for
+ * this thread's {@code ClassLoader}.
* Next, this object's listeners are deserialized by reading a
- * <code>null</code>-terminated sequence of 0 or more key/value pairs
+ * {@code null}-terminated sequence of 0 or more key/value pairs
* from the stream:
* <ul>
- * <li>If a key object is a <code>String</code> equal to
- * <code>dragSourceListenerK</code>, a <code>DragSourceListener</code> is
+ * <li>If a key object is a {@code String} equal to
+ * {@code dragSourceListenerK}, a {@code DragSourceListener} is
* deserialized using the corresponding value object and added to this
- * <code>DragSource</code>.
- * <li>If a key object is a <code>String</code> equal to
- * <code>dragSourceMotionListenerK</code>, a
- * <code>DragSourceMotionListener</code> is deserialized using the
- * corresponding value object and added to this <code>DragSource</code>.
+ * {@code DragSource}.
+ * <li>If a key object is a {@code String} equal to
+ * {@code dragSourceMotionListenerK}, a
+ * {@code DragSourceMotionListener} is deserialized using the
+ * corresponding value object and added to this {@code DragSource}.
* <li>Otherwise, the key/value pair is skipped.
* </ul>
*
* @see java.awt.datatransfer.SystemFlavorMap#getDefaultFlavorMap
* @since 1.4
@@ -882,17 +882,17 @@
/**
* Returns the drag gesture motion threshold. The drag gesture motion threshold
* defines the recommended behavior for {@link MouseDragGestureRecognizer}s.
* <p>
- * If the system property <code>awt.dnd.drag.threshold</code> is set to
+ * If the system property {@code awt.dnd.drag.threshold} is set to
* a positive integer, this method returns the value of the system property;
* otherwise if a pertinent desktop property is available and supported by
* the implementation of the Java platform, this method returns the value of
* that property; otherwise this method returns some default value.
* The pertinent desktop property can be queried using
- * <code>java.awt.Toolkit.getDesktopProperty("DnD.gestureMotionThreshold")</code>.
+ * {@code java.awt.Toolkit.getDesktopProperty("DnD.gestureMotionThreshold")}.
*
* @return the drag gesture motion threshold
* @see MouseDragGestureRecognizer
* @since 1.5
*/
< prev index next >