Bug ID: JDK-4687735 Incomplete specification of ClipboardOwner.

Versions (Unresolved/Resolved/Fixed)

The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.

Other
1.4.2 mantisFixed


Name: agR10216			Date: 05/18/2002

###@###.###

The javadoc for ClipboardOwner.lostOwnership() is incomplete as it
doesn't specify when this method is invoked. The name implies that 
it is called after another object (or another application in case of
the system clipboard) has acquired clipboard ownership. However,
developers cannot rely on it until it is specified in the javadoc.

The javadoc for ClipboardOwner interface is insufficient in that it
doesn't define the notion of the clipboard owner and it doesn't
specify when the object that implements this interface acts as the
owner of a particular Clipboard.

###@###.### 2002-05-18
======================================================================

CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: mantis FIXED IN: mantis INTEGRATED IN: mantis mantis-b08
17-09-2004
WORK AROUND Name: agR10216 Date: 05/18/2002 ======================================================================
17-09-2004
SUGGESTED FIX Name: agR10216 Date: 10/26/2002 --- ClipboardOwner.java Thu Oct 24 19:25:56 2002 ************* * 9,15 ** / * Defines the interface for classes that will provide data to ! * a clipboard. * * @version %I%, %G% * @author Amy Fowler --- 9,24 ---- /** * Defines the interface for classes that will provide data to ! * a clipboard. An instance of this interface becomes the owner ! * of the contents of a clipboard (clipboard owner) if it is ! * passed as an argument to ! * {@link java.awt.datatransfer.Clipboard#setContents} method of ! * the clipboard and this method returns successfully. ! * The instance remains the clipboard owner until another application ! * or another object within this application asserts ownership ! * of this clipboard. ! * ! * @see java.awt.datatransfer.Clipboard * * @version %I%, %G% * @author Amy Fowler ************* * 18,25 ** public interface ClipboardOwner { / ! * Notifies this object that it is no longer the owner of ! * the contents of the clipboard. * @param clipboard the clipboard that is no longer owned * @param contents the contents which this owner had placed on the clipboard / --- 27,36 ---- public interface ClipboardOwner { /* ! * Notifies this object that it is no longer the clipboard owner. ! * This method will be called when another application or another ! * object within this application asserts ownership of the clipboard. ! * * @param clipboard the clipboard that is no longer owned * @param contents the contents which this owner had placed on the clipboard */ ###@###.### 2002-10-25 ======================================================================
25-10-2002
EVALUATION Name: agR10216 Date: 10/26/2002 The specification of the interface ClipboardOwner should be clarified. ###@###.### 2002-10-25 ======================================================================
25-10-2002