stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8038242: Tidy warnings cleanup for java.awt.datatransfer, java.awt.dnd, java.awt.event

Browse Source 
Reviewed-by: pchelko, serb
This commit is contained in:
Alexander Stepanov 2014-03-28 14:33:53 +04:00 committed by Yuri Nesterenko
parent d056456ee8
commit a916ed751a
19 changed files with 133 additions and 134 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
jdk/src/share/classes/java/awt/datatransfer/FlavorListener.java
View File

@ -38,7 +38,7 @@ public interface FlavorListener extends EventListener {
* Invoked when the target {@link Clipboard} of the listener
* has changed its available {@link DataFlavor}s.
* <p>
* Some notifications may be redundant &#151; they are not
* Some notifications may be redundant &#8212; they are not
* caused by a change of the set of DataFlavors available
* on the clipboard.
* For example, if the clipboard subsystem supposes that

1
jdk/src/share/classes/java/awt/datatransfer/SystemFlavorMap.java
View File

@ -54,7 +54,6 @@ import sun.awt.datatransfer.DataTransferer;
* which correspond to platform-independent MIME types. This mapping is used
* by the data transfer subsystem to transfer data between Java and native
* applications, and between Java applications in separate VMs.
* <p>
*
* @since 1.2
*/

4
jdk/src/share/classes/java/awt/dnd/Autoscroll.java
View File

@ -62,7 +62,7 @@ public interface Autoscroll {
* This value is read once by the <code>DropTarget</code>
* upon entry of the drag <code>Cursor</code>
* into the associated <code>Component</code>.
* <P>
*
* @return the Insets
*/
@ -70,7 +70,7 @@ public interface Autoscroll {
/**
* notify the <code>Component</code> to autoscroll
* <P>
*
* @param cursorLocn A <code>Point</code> indicating the
* location of the cursor that triggered this operation.
*/

32
jdk/src/share/classes/java/awt/dnd/DragGestureEvent.java
View File

@ -82,14 +82,14 @@ public class DragGestureEvent extends EventObject {
* the user's preferred action, an {@code ori} parameter
* indicating the origin of the drag, and a {@code List} of
* events that comprise the gesture({@code evs} parameter).
* <P>
*
* @param dgr The <code>DragGestureRecognizer</code> firing this event
* @param act The user's preferred action.
* For information on allowable values, see
* the class description for {@link DragGestureEvent}
* @param ori The origin of the drag
* @param evs The <code>List</code> of events that comprise the gesture
* <P>
*
* @throws IllegalArgumentException if any parameter equals {@code null}
* @throws IllegalArgumentException if the act parameter does not comply with
* the values given in the class
@ -124,7 +124,7 @@ public class DragGestureEvent extends EventObject {
/**
* Returns the source as a <code>DragGestureRecognizer</code>.
* <P>
*
* @return the source as a <code>DragGestureRecognizer</code>
*/
@ -135,7 +135,7 @@ public class DragGestureEvent extends EventObject {
/**
* Returns the <code>Component</code> associated
* with this <code>DragGestureEvent</code>.
* <P>
*
* @return the Component
*/
@ -143,7 +143,7 @@ public class DragGestureEvent extends EventObject {
/**
* Returns the <code>DragSource</code>.
* <P>
*
* @return the <code>DragSource</code>
*/
@ -152,7 +152,7 @@ public class DragGestureEvent extends EventObject {
/**
* Returns a <code>Point</code> in the coordinates
* of the <code>Component</code> over which the drag originated.
* <P>
*
* @return the Point where the drag originated in Component coords.
*/
@ -163,7 +163,7 @@ public class DragGestureEvent extends EventObject {
/**
* Returns an <code>Iterator</code> for the events
* comprising the gesture.
* <P>
*
* @return an Iterator for the events comprising the gesture
*/
@SuppressWarnings("unchecked")
@ -172,7 +172,7 @@ public class DragGestureEvent extends EventObject {
/**
* Returns an <code>Object</code> array of the
* events comprising the drag gesture.
* <P>
*
* @return an array of the events comprising the gesture
*/
@ -180,9 +180,9 @@ public class DragGestureEvent extends EventObject {
/**
* Returns an array of the events comprising the drag gesture.
* <P>
*
* @param array the array of <code>EventObject</code> sub(types)
* <P>
*
* @return an array of the events comprising the gesture
*/
@SuppressWarnings("unchecked")
@ -191,7 +191,7 @@ public class DragGestureEvent extends EventObject {
/**
* Returns an <code>int</code> representing the
* action selected by the user.
* <P>
*
* @return the action selected by the user
*/
@ -199,7 +199,7 @@ public class DragGestureEvent extends EventObject {
/**
* Returns the initial event that triggered the gesture.
* <P>
*
* @return the first "triggering" event in the sequence of the gesture
*/
@ -242,7 +242,7 @@ public class DragGestureEvent extends EventObject {
* Starts the drag given the initial <code>Cursor</code> to display,
* the <code>Transferable</code> object,
* and the <code>DragSourceListener</code> to use.
* <P>
*
* @param dragCursor The initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see
@ -251,7 +251,7 @@ public class DragGestureEvent extends EventObject {
* during drag and drop
* @param transferable The source's Transferable
* @param dsl The source's DragSourceListener
* <P>
*
* @throws InvalidDnDOperationException if
* the Drag and Drop system is unable to
* initiate a drag operation, or if the user
@ -269,7 +269,7 @@ public class DragGestureEvent extends EventObject {
* the <code>Image</code>,
* the <code>Transferable</code> object, and
* the <code>DragSourceListener</code> to use.
* <P>
*
* @param dragCursor The initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
* see
@ -280,7 +280,7 @@ public class DragGestureEvent extends EventObject {
* @param imageOffset The dragImage's offset
* @param transferable The source's Transferable
* @param dsl The source's DragSourceListener
* <P>
*
* @throws InvalidDnDOperationException if
* the Drag and Drop system is unable to
* initiate a drag operation, or if the user

2
jdk/src/share/classes/java/awt/dnd/DragGestureListener.java
View File

@ -53,7 +53,7 @@ import java.util.EventListener;
* drag initiating gesture. To initiate the drag and drop operation,
* if appropriate, {@link DragGestureEvent#startDrag startDrag()} method on
* the {@code DragGestureEvent} has to be invoked.
* <P>
*
* @see java.awt.dnd.DragGestureRecognizer
* @see java.awt.dnd.DragGestureEvent
* @param dge the <code>DragGestureEvent</code> describing

44
jdk/src/share/classes/java/awt/dnd/DragGestureRecognizer.java
View File

@ -76,7 +76,7 @@ import java.io.Serializable;
* for causing the associated
* <code>DragSource</code> to start the Drag and Drop operation (if
* appropriate).
* <P>
*
* @author Laurence P. G. Cable
* @see java.awt.dnd.DragGestureListener
* @see java.awt.dnd.DragGestureEvent
@ -96,7 +96,7 @@ public abstract class DragGestureRecognizer implements Serializable {
* for this Drag and Drop operation, and the
* <code>DragGestureListener</code> to notify
* once a drag initiating gesture has been detected.
* <P>
*
* @param ds the <code>DragSource</code> this
* <code>DragGestureRecognizer</code>
* will use to process the Drag and Drop operation
@ -115,7 +115,7 @@ public abstract class DragGestureRecognizer implements Serializable {
*
* @param dgl the <code>DragGestureRecognizer</code>
* to notify when a drag gesture is detected
* <P>
*
* @throws IllegalArgumentException
* if ds is <code>null</code>.
*/
@ -144,7 +144,7 @@ public abstract class DragGestureRecognizer implements Serializable {
* <code>DragGestureRecognizer</code> should "observe"
* for drag initiating gestures, and the action(s)
* supported for this Drag and Drop operation.
* <P>
*
* @param ds the <code>DragSource</code> this
* <code>DragGestureRecognizer</code> will use to
* process the Drag and Drop operation
@ -158,7 +158,7 @@ public abstract class DragGestureRecognizer implements Serializable {
*
* @param sa the set (logical OR) of the <code>DnDConstants</code>
* that this Drag and Drop operation will support
* <P>
*
* @throws IllegalArgumentException
* if ds is <code>null</code>.
*/
@ -174,7 +174,7 @@ public abstract class DragGestureRecognizer implements Serializable {
* the <code>Component</code> this
* <code>DragGestureRecognizer</code>
* should "observe" for drag initiating gestures.
* <P>
*
* @param ds the <code>DragSource</code> this
* <code>DragGestureRecognizer</code>
* will use to process the Drag and Drop operation
@ -186,7 +186,7 @@ public abstract class DragGestureRecognizer implements Serializable {
* If this value is <code>null</code>,
* the <code>DragGestureRecognizer</code>
* is not associated with any <code>Component</code>.
* <P>
*
* @throws IllegalArgumentException
* if ds is <code>null</code>.
*/
@ -199,11 +199,11 @@ public abstract class DragGestureRecognizer implements Serializable {
* Construct a new <code>DragGestureRecognizer</code>
* given the <code>DragSource</code> to be used in this
* Drag and Drop operation.
* <P>
*
* @param ds the <code>DragSource</code> this
* <code>DragGestureRecognizer</code> will
* use to process the Drag and Drop operation
* <P>
*
* @throws IllegalArgumentException
* if ds is <code>null</code>.
*/
@ -233,7 +233,7 @@ public abstract class DragGestureRecognizer implements Serializable {
* this <code>DragGestureRecognizer</code>
* will use in order to process the Drag and Drop
* operation.
* <P>
*
* @return the DragSource
*/
@ -244,7 +244,7 @@ public abstract class DragGestureRecognizer implements Serializable {
* that is to be "observed" by the
* <code>DragGestureRecognizer</code>
* for drag initiating gestures.
* <P>
*
* @return The Component this DragGestureRecognizer
* is associated with
*/
@ -256,7 +256,7 @@ public abstract class DragGestureRecognizer implements Serializable {
*
* registerListeners() and unregisterListeners() are called as a side
* effect as appropriate.
* <P>
*
* @param c The <code>Component</code> or <code>null</code>
*/
@ -274,7 +274,7 @@ public abstract class DragGestureRecognizer implements Serializable {
* This method returns an int representing the
* type of action(s) this Drag and Drop
* operation will support.
* <P>
*
* @return the currently permitted source action(s)
*/
@ -283,7 +283,7 @@ public abstract class DragGestureRecognizer implements Serializable {
/**
* This method sets the permitted source drag action(s)
* for this Drag and Drop operation.
* <P>
*
* @param actions the permitted source drag action(s)
*/
@ -295,7 +295,7 @@ public abstract class DragGestureRecognizer implements Serializable {
* This method returns the first event in the
* series of events that initiated
* the Drag and Drop operation.
* <P>
*
* @return the initial event that triggered the drag gesture
*/
@ -310,10 +310,10 @@ public abstract class DragGestureRecognizer implements Serializable {
/**
* Register a new <code>DragGestureListener</code>.
* <P>
*
* @param dgl the <code>DragGestureListener</code> to register
* with this <code>DragGestureRecognizer</code>.
* <P>
*
* @throws java.util.TooManyListenersException if a
* <code>DragGestureListener</code> has already been added.
*/
@ -330,10 +330,10 @@ public abstract class DragGestureRecognizer implements Serializable {
/**
* unregister the current DragGestureListener
* <P>
*
* @param dgl the <code>DragGestureListener</code> to unregister
* from this <code>DragGestureRecognizer</code>
* <P>
*
* @throws IllegalArgumentException if
* dgl is not (equal to) the currently registered <code>DragGestureListener</code>.
*/
@ -351,7 +351,7 @@ public abstract class DragGestureRecognizer implements Serializable {
/**
* Notify the DragGestureListener that a Drag and Drop initiating
* gesture has occurred. Then reset the state of the Recognizer.
* <P>
*
* @param dragAction The action initially selected by the users gesture
* @param p The point (in Component coords) where the gesture originated
*/
@ -369,14 +369,14 @@ public abstract class DragGestureRecognizer implements Serializable {
* Listeners registered on the Component by this Recognizer shall record
* all Events that are recognized as part of the series of Events that go
* to comprise a Drag and Drop initiating gesture via this API.
*<P>
* <P>
* This method is used by a <code>DragGestureRecognizer</code>
* implementation to add an <code>InputEvent</code>
* subclass (that it believes is one in a series
* of events that comprise a Drag and Drop operation)
* to the array of events that this
* <code>DragGestureRecognizer</code> maintains internally.
* <P>
*
* @param awtie the <code>InputEvent</code>
* to add to this <code>DragGestureRecognizer</code>'s
* internal array of events. Note that <code>null</code>

30
jdk/src/share/classes/java/awt/dnd/DragSource.java
View File

@ -228,7 +228,7 @@ public class DragSource implements Serializable {
* whether or not drag
* <code>Image</code> support
* is available on the underlying platform.
* <P>
*
* @return if the Drag Image support is available on this platform
*/
@ -270,7 +270,7 @@ public class DragSource implements Serializable {
* the <code>Transferable</code> subject data
* of the drag, the <code>DragSourceListener</code>,
* and the <code>FlavorMap</code>.
* <P>
*
* @param trigger the <code>DragGestureEvent</code> that initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
@ -282,7 +282,7 @@ public class DragSource implements Serializable {
* @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>
* <P>
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
* system is unable to initiate a drag operation, or if the user
@ -332,7 +332,7 @@ public class DragSource implements Serializable {
* the <code>Transferable</code> subject data
* of the drag, the <code>DragSourceListener</code>,
* and the <code>FlavorMap</code>.
* <P>
*
* @param trigger the <code>DragGestureEvent</code> that
* initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
@ -342,7 +342,7 @@ public class DragSource implements Serializable {
* @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>
* <P>
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
* system is unable to initiate a drag operation, or if the user
@ -368,7 +368,7 @@ public class DragSource implements Serializable {
* at the instant of the trigger,
* the subject data of the drag, and
* the <code>DragSourceListener</code>.
* <P>
*
* @param trigger the <code>DragGestureEvent</code> that initiated the drag
* @param dragCursor the initial {@code Cursor} for this drag operation
* or {@code null} for the default cursor handling;
@ -379,7 +379,7 @@ public class DragSource implements Serializable {
* of the <code>Cursor</code> at the instant of the trigger
* @param transferable the subject data of the drag
* @param dsl the <code>DragSourceListener</code>
* <P>
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
* system is unable to initiate a drag operation, or if the user
@ -403,15 +403,15 @@ public class DragSource implements Serializable {
* use,
* the <code>Transferable</code> subject data
* of the drag, and the <code>DragSourceListener</code>.
* <P>
* @param trigger the <code>DragGestureEvent</code> that initiated the drag
*
* @param trigger the <code>DragGestureEvent</code> 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>
* <P>
*
* @throws java.awt.dnd.InvalidDnDOperationException
* if the Drag and Drop
* system is unable to initiate a drag operation, or if the user
@ -480,7 +480,7 @@ public class DragSource implements Serializable {
/**
* This method returns the
* <code>FlavorMap</code> for this <code>DragSource</code>.
* <P>
*
* @return the <code>FlavorMap</code> for this <code>DragSource</code>
*/
@ -494,13 +494,13 @@ public class DragSource implements Serializable {
* sets the specified <code>Component</code>
* and <code>DragGestureListener</code> on
* the newly created object.
* <P>
*
* @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
* <P>
*
* @return the new <code>DragGestureRecognizer</code> or <code>null</code>
* if the <code>Toolkit.createDragGestureRecognizer</code> method
* has no implementation available for
@ -528,11 +528,11 @@ public class DragSource implements Serializable {
*
* For this <code>DragSource</code>
* the default is <code>MouseDragGestureRecognizer</code>.
* <P>
*
* @param c the <code>Component</code> target for the recognizer
* @param actions the permitted source actions
* @param dgl the <code>DragGestureListener</code> to notify
* <P>
*
* @return the new <code>DragGestureRecognizer</code> or <code>null</code>
* if the <code>Toolkit.createDragGestureRecognizer</code> method
* has no implementation available for

6
jdk/src/share/classes/java/awt/dnd/DragSourceContext.java
View File

@ -289,7 +289,7 @@ public class DragSourceContext
/**
* Returns the current drag <code>Cursor</code>.
* <P>
*
* @return the current drag <code>Cursor</code>
*/
@ -300,11 +300,11 @@ public class DragSourceContext
* <code>DragSourceContext</code> if one has not already been added.
* If a <code>DragSourceListener</code> already exists,
* this method throws a <code>TooManyListenersException</code>.
* <P>
*
* @param dsl the <code>DragSourceListener</code> to add.
* Note that while <code>null</code> is not prohibited,
* it is not acceptable as a parameter.
* <P>
*
* @throws TooManyListenersException if
* a <code>DragSourceListener</code> has already been added
*/

2
jdk/src/share/classes/java/awt/dnd/DragSourceDropEvent.java
View File

@ -36,7 +36,7 @@ package java.awt.dnd;
* originator of the operation
* to provide appropriate feedback to the end user
* when the operation completes.
* <P>
*
* @since 1.2
*/

2
jdk/src/share/classes/java/awt/dnd/DragSourceEvent.java
View File

@ -131,7 +131,7 @@ public class DragSourceEvent extends EventObject {
/**
* This method returns the <code>DragSourceContext</code> that
* originated the event.
* <P>
*
* @return the <code>DragSourceContext</code> that originated the event
*/

36
jdk/src/share/classes/java/awt/dnd/DropTarget.java
View File

@ -234,7 +234,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* Gets the <code>Component</code> associated
* with this <code>DropTarget</code>.
* <P>
*
* @return the current <code>Component</code>
*/
@ -244,7 +244,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* Sets the default acceptable actions for this <code>DropTarget</code>
* <P>
*
* @param ops the default actions
* @see java.awt.dnd.DnDConstants
*/
@ -264,7 +264,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* Gets an <code>int</code> representing the
* current action(s) supported by this <code>DropTarget</code>.
* <P>
*
* @return the current default actions
*/
@ -275,7 +275,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* Sets the DropTarget active if <code>true</code>,
* inactive if <code>false</code>.
* <P>
*
* @param isActive sets the <code>DropTarget</code> (in)active.
*/
@ -291,7 +291,7 @@ public class DropTarget implements DropTargetListener, Serializable {
* Reports whether or not
* this <code>DropTarget</code>
* is currently active (ready to accept drops).
* <P>
*
* @return <CODE>true</CODE> if active, <CODE>false</CODE> if not
*/
@ -301,9 +301,9 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* Adds a new <code>DropTargetListener</code> (UNICAST SOURCE).
* <P>
*
* @param dtl The new <code>DropTargetListener</code>
* <P>
*
* @throws TooManyListenersException if a
* <code>DropTargetListener</code> is already added to this
* <code>DropTarget</code>.
@ -322,7 +322,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* Removes the current <code>DropTargetListener</code> (UNICAST SOURCE).
* <P>
*
* @param dtl the DropTargetListener to deregister.
*/
@ -464,7 +464,7 @@ public class DropTarget implements DropTargetListener, Serializable {
* If no <code>FlavorMap</code> has been set for this
* <code>DropTarget</code>, it is associated with the default
* <code>FlavorMap</code>.
* <P>
*
* @return the FlavorMap for this DropTarget
*/
@ -473,7 +473,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* Sets the <code>FlavorMap</code> associated
* with this <code>DropTarget</code>.
* <P>
*
* @param fm the new <code>FlavorMap</code>, or null to
* associate the default FlavorMap with this DropTarget.
*/
@ -494,7 +494,7 @@ public class DropTarget implements DropTargetListener, Serializable {
* association of the ComponentPeer with the Component may result in
* a malfunction of the DnD system.
**********************************************************************
* <P>
*
* @param peer The Peer of the Component we are associated with!
*
*/
@ -529,7 +529,7 @@ public class DropTarget implements DropTargetListener, Serializable {
* disassociation of the ComponentPeer from the Component may result in
* a malfunction of the DnD system.
**********************************************************************
* <P>
*
* @param peer The Peer of the Component we are being disassociated from!
*/
@ -549,7 +549,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* Gets the <code>DropTargetContext</code> associated
* with this <code>DropTarget</code>.
* <P>
*
* @return the <code>DropTargetContext</code> associated with this <code>DropTarget</code>.
*/
@ -641,7 +641,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* construct a DropTargetAutoScroller
* <P>
*
* @param c the <code>Component</code>
* @param p the <code>Point</code>
*/
@ -710,7 +710,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* cause autoscroll to occur
* <P>
*
* @param newLocn the <code>Point</code>
*/
@ -734,7 +734,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* cause autoscroll to occur
* <P>
*
* @param e the <code>ActionEvent</code>
*/
@ -779,7 +779,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* initialize autoscrolling
* <P>
*
* @param p the <code>Point</code>
*/
@ -791,7 +791,7 @@ public class DropTarget implements DropTargetListener, Serializable {
/**
* update autoscrolling with current cursor location
* <P>
*
* @param dragCursorLocn the <code>Point</code>
*/

38
jdk/src/share/classes/java/awt/dnd/DropTargetContext.java
View File

@ -61,7 +61,7 @@ public class DropTargetContext implements Serializable {
/**
* Construct a <code>DropTargetContext</code>
* given a specified <code>DropTarget</code>.
* <P>
*
* @param dt the DropTarget to associate with
*/
@ -74,7 +74,7 @@ public class DropTargetContext implements Serializable {
/**
* This method returns the <code>DropTarget</code> associated with this
* <code>DropTargetContext</code>.
* <P>
*
* @return the <code>DropTarget</code> associated with this <code>DropTargetContext</code>
*/
@ -83,7 +83,7 @@ public class DropTargetContext implements Serializable {
/**
* This method returns the <code>Component</code> associated with
* this <code>DropTargetContext</code>.
* <P>
*
* @return the Component associated with this Context
*/
@ -91,7 +91,7 @@ public class DropTargetContext implements Serializable {
/**
* Called when associated with the <code>DropTargetContextPeer</code>.
* <P>
*
* @param dtcp the <code>DropTargetContextPeer</code>
*/
@ -111,7 +111,7 @@ public class DropTargetContext implements Serializable {
/**
* This method sets the current actions acceptable to
* this <code>DropTarget</code>.
* <P>
*
* @param actions an <code>int</code> representing the supported action(s)
*/
@ -130,7 +130,7 @@ public class DropTargetContext implements Serializable {
/**
* This method returns an <code>int</code> representing the
* current actions this <code>DropTarget</code> will accept.
* <P>
*
* @return the current actions acceptable to this <code>DropTarget</code>
*/
@ -145,9 +145,9 @@ public class DropTargetContext implements Serializable {
/**
* This method signals that the drop is completed and
* if it was successful or not.
* <P>
*
* @param success true for success, false if not
* <P>
*
* @throws InvalidDnDOperationException if a drop is not outstanding/extant
*/
@ -160,7 +160,7 @@ public class DropTargetContext implements Serializable {
/**
* accept the Drag.
* <P>
*
* @param dragOperation the supported action(s)
*/
@ -186,7 +186,7 @@ public class DropTargetContext implements Serializable {
* called to signal that the drop is acceptable
* using the specified operation.
* must be called during DropTargetListener.drop method invocation.
* <P>
*
* @param dropOperation the supported action(s)
*/
@ -212,7 +212,7 @@ public class DropTargetContext implements Serializable {
/**
* get the available DataFlavors of the
* <code>Transferable</code> operand of this operation.
* <P>
*
* @return a <code>DataFlavor[]</code> containing the
* supported <code>DataFlavor</code>s of the
* <code>Transferable</code> operand.
@ -227,7 +227,7 @@ public class DropTargetContext implements Serializable {
* This method returns a the currently available DataFlavors
* of the <code>Transferable</code> operand
* as a <code>java.util.List</code>.
* <P>
*
* @return the currently available
* DataFlavors as a <code>java.util.List</code>
*/
@ -240,9 +240,9 @@ public class DropTargetContext implements Serializable {
* This method returns a <code>boolean</code>
* indicating if the given <code>DataFlavor</code> is
* supported by this <code>DropTargetContext</code>.
* <P>
*
* @param df the <code>DataFlavor</code>
* <P>
*
* @return if the <code>DataFlavor</code> specified is supported
*/
@ -252,9 +252,9 @@ public class DropTargetContext implements Serializable {
/**
* get the Transferable (proxy) operand of this operation
* <P>
*
* @throws InvalidDnDOperationException if a drag is not outstanding/extant
* <P>
*
* @return the <code>Transferable</code>
*/
@ -279,7 +279,7 @@ public class DropTargetContext implements Serializable {
/**
* Get the <code>DropTargetContextPeer</code>
* <P>
*
* @return the platform peer
*/
@ -322,7 +322,7 @@ public class DropTargetContext implements Serializable {
* data transfer for a particular drag-n-drop operation and
* a <code>boolean</code> which indicates whether the
* drag-n-drop operation is local (within the same JVM).
* <p>
*
* @param t the <code>Transferable</code> object
* @param local <code>true</code>, if <code>t</code> represents
* the result of local drag-n-drop operation
@ -336,7 +336,7 @@ public class DropTargetContext implements Serializable {
/**
* Returns an array of DataFlavor objects indicating the flavors
* the data can be provided in by the encapsulated transferable.
* <p>
*
* @return an array of data flavors in which the data can be
* provided by the encapsulated transferable
*/

12
jdk/src/share/classes/java/awt/dnd/DropTargetDragEvent.java
View File

@ -80,7 +80,7 @@ public class DropTargetDragEvent extends DropTargetEvent {
* the location of the "Drag" <code>Cursor</code>'s hotspot
* in the <code>Component</code>'s coordinates, the
* user drop action, and the source drop actions.
* <P>
*
* @param dtc The DropTargetContext for this operation
* @param cursorLocn The location of the "Drag" Cursor's
* hotspot in Component coordinates
@ -118,7 +118,7 @@ public class DropTargetDragEvent extends DropTargetEvent {
* indicating the <code>Cursor</code>'s current
* location within the <code>Component'</code>s
* coordinates.
* <P>
*
* @return the current cursor location in
* <code>Component</code>'s coords.
*/
@ -131,7 +131,7 @@ public class DropTargetDragEvent extends DropTargetEvent {
/**
* This method returns the current <code>DataFlavor</code>s from the
* <code>DropTargetContext</code>.
* <P>
*
* @return current DataFlavors from the DropTargetContext
*/
@ -142,7 +142,7 @@ public class DropTargetDragEvent extends DropTargetEvent {
/**
* This method returns the current <code>DataFlavor</code>s
* as a <code>java.util.List</code>
* <P>
*
* @return a <code>java.util.List</code> of the Current <code>DataFlavor</code>s
*/
@ -153,9 +153,9 @@ public class DropTargetDragEvent extends DropTargetEvent {
/**
* This method returns a <code>boolean</code> indicating
* if the specified <code>DataFlavor</code> is supported.
* <P>
*
* @param df the <code>DataFlavor</code> to test
* <P>
*
* @return if a particular DataFlavor is supported
*/

22
jdk/src/share/classes/java/awt/dnd/DropTargetDropEvent.java
View File

@ -85,7 +85,7 @@ public class DropTargetDropEvent extends DropTargetEvent {
* assumes that the target is not in the same virtual machine as
* the source; that is, {@link #isLocalTransfer()} will
* return <code>false</code>.
* <P>
*
* @param dtc The <code>DropTargetContext</code> for this operation
* @param cursorLocn The location of the "Drag" Cursor's
* hotspot in <code>Component</code> coordinates
@ -128,7 +128,7 @@ public class DropTargetDropEvent extends DropTargetEvent {
* the current set of actions supported by the source,
* and a <code>boolean</code> indicating if the source is in the same JVM
* as the target.
* <P>
*
* @param dtc The DropTargetContext for this operation
* @param cursorLocn The location of the "Drag" Cursor's
* hotspot in Component's coordinates
@ -154,7 +154,7 @@ public class DropTargetDropEvent extends DropTargetEvent {
* This method returns a <code>Point</code>
* indicating the <code>Cursor</code>'s current
* location in the <code>Component</code>'s coordinates.
* <P>
*
* @return the current <code>Cursor</code> location in Component's coords.
*/
@ -165,7 +165,7 @@ public class DropTargetDropEvent extends DropTargetEvent {
/**
* This method returns the current DataFlavors.
* <P>
*
* @return current DataFlavors
*/
@ -176,7 +176,7 @@ public class DropTargetDropEvent extends DropTargetEvent {
/**
* This method returns the currently available
* <code>DataFlavor</code>s as a <code>java.util.List</code>.
* <P>
*
* @return the currently available DataFlavors as a java.util.List
*/
@ -188,9 +188,9 @@ public class DropTargetDropEvent extends DropTargetEvent {
* This method returns a <code>boolean</code> indicating if the
* specified <code>DataFlavor</code> is available
* from the source.
* <P>
*
* @param df the <code>DataFlavor</code> to test
* <P>
*
* @return if the DataFlavor specified is available from the source
*/
@ -215,7 +215,7 @@ public class DropTargetDropEvent extends DropTargetEvent {
/**
* This method returns the <code>Transferable</code> object
* associated with the drop.
* <P>
*
* @return the <code>Transferable</code> associated with the drop
*/
@ -225,7 +225,7 @@ public class DropTargetDropEvent extends DropTargetEvent {
/**
* accept the drop, using the specified action.
* <P>
*
* @param dropAction the specified action
*/
@ -244,7 +244,7 @@ public class DropTargetDropEvent extends DropTargetEvent {
/**
* This method notifies the <code>DragSource</code>
* that the drop transfer(s) are completed.
* <P>
*
* @param success a <code>boolean</code> indicating that the drop transfer(s) are completed.
*/
@ -255,7 +255,7 @@ public class DropTargetDropEvent extends DropTargetEvent {
/**
* This method returns an <code>int</code> indicating if
* the source is in the same JVM as the target.
* <P>
*
* @return if the Source is in the same JVM
*/

4
jdk/src/share/classes/java/awt/dnd/DropTargetEvent.java
View File

@ -47,7 +47,7 @@ public class DropTargetEvent extends java.util.EventObject {
/**
* Construct a <code>DropTargetEvent</code> object with
* the specified <code>DropTargetContext</code>.
* <P>
*
* @param dtc The <code>DropTargetContext</code>
* @throws NullPointerException if {@code dtc} equals {@code null}.
* @see #getSource()
@ -63,7 +63,7 @@ public class DropTargetEvent extends java.util.EventObject {
/**
* This method returns the <code>DropTargetContext</code>
* associated with this <code>DropTargetEvent</code>.
* <P>
*
* @return the <code>DropTargetContext</code>
*/

4
jdk/src/share/classes/java/awt/dnd/DropTargetListener.java
View File

@ -91,7 +91,7 @@ public interface DropTargetListener extends EventListener {
/**
* Called if the user has modified
* the current drop gesture.
* <P>
*
* @param dtde the <code>DropTargetDragEvent</code>
*/
@ -144,7 +144,7 @@ public interface DropTargetListener extends EventListener {
* <code>DropTargetDropEvent.isLocalTransfer()</code> returns
* <code>true</code>. Otherwise, the behavior of the call is
* implementation-dependent.
* <P>
*
* @param dtde the <code>DropTargetDropEvent</code>
*/

2
jdk/src/share/classes/java/awt/dnd/InvalidDnDOperationException.java
View File

@ -48,7 +48,7 @@ public class InvalidDnDOperationException extends IllegalStateException {
/**
* Create an Exception with its own descriptive message
* <P>
*
* @param msg the detail message
*/

22
jdk/src/share/classes/java/awt/dnd/MouseDragGestureRecognizer.java
View File

@ -74,7 +74,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
* permitted for this drag operation, and
* the <code>DragGestureListener</code> to
* notify when a drag gesture is detected.
* <P>
*
* @param ds The DragSource for the Component c
* @param c The Component to observe
* @param act The actions permitted for this Drag
@ -92,7 +92,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
* the <code>Component</code> c,
* the <code>Component</code> to observe, and the action(s)
* permitted for this drag operation.
* <P>
*
* @param ds The DragSource for the Component c
* @param c The Component to observe
* @param act The actions permitted for this drag
@ -107,7 +107,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
* given the <code>DragSource</code> for the
* <code>Component</code> c, and the
* <code>Component</code> to observe.
* <P>
*
* @param ds The DragSource for the Component c
* @param c The Component to observe
*/
@ -119,7 +119,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
/**
* Construct a new <code>MouseDragGestureRecognizer</code>
* given the <code>DragSource</code> for the <code>Component</code>.
* <P>
*
* @param ds The DragSource for the Component
*/
@ -150,7 +150,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
/**
* Invoked when the mouse has been clicked on a component.
* <P>
*
* @param e the <code>MouseEvent</code>
*/
@ -159,7 +159,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
/**
* Invoked when a mouse button has been
* pressed on a <code>Component</code>.
* <P>
*
* @param e the <code>MouseEvent</code>
*/
@ -167,7 +167,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
/**
* Invoked when a mouse button has been released on a component.
* <P>
*
* @param e the <code>MouseEvent</code>
*/
@ -175,7 +175,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
/**
* Invoked when the mouse enters a component.
* <P>
*
* @param e the <code>MouseEvent</code>
*/
@ -183,7 +183,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
/**
* Invoked when the mouse exits a component.
* <P>
*
* @param e the <code>MouseEvent</code>
*/
@ -191,7 +191,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
/**
* Invoked when a mouse button is pressed on a component.
* <P>
*
* @param e the <code>MouseEvent</code>
*/
@ -200,7 +200,7 @@ public abstract class MouseDragGestureRecognizer extends DragGestureRecognizer i
/**
* Invoked when the mouse button has been moved on a component
* (with no buttons no down).
* <P>
*
* @param e the <code>MouseEvent</code>
*/

2
jdk/src/share/classes/java/awt/event/MouseEvent.java
View File

@ -930,7 +930,7 @@ public class MouseEvent extends InputEvent {
* and will cause the returning an unspecified string.
* Zero parameter means that no modifiers were passed and will
* cause the returning an empty string.
* <p>
*
* @param modifiers A modifier mask describing the modifier keys and
* mouse buttons that were down during the event
* @return string string text description of the combination of modifier