1. /*

  2.  * @(#)ClipboardOwner.java	1.11 03/12/19

  3.  *

  4.  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package java.awt.datatransfer;

  9. 

  10. /**

  11.  * Defines the interface for classes that will provide data to

  12.  * a clipboard. An instance of this interface becomes the owner

  13.  * of the contents of a clipboard (clipboard owner) if it is

  14.  * passed as an argument to

  15.  * {@link java.awt.datatransfer.Clipboard#setContents} method of

  16.  * the clipboard and this method returns successfully. 

  17.  * The instance remains the clipboard owner until another application

  18.  * or another object within this application asserts ownership

  19.  * of this clipboard.

  20.  *

  21.  * @see java.awt.datatransfer.Clipboard

  22.  * 

  23.  * @version 	1.11, 12/19/03

  24.  * @author	Amy Fowler

  25.  */

  26. 

  27. public interface ClipboardOwner {

  28. 

  29.     /**

  30.      * Notifies this object that it is no longer the clipboard owner.

  31.      * This method will be called when another application or another

  32.      * object within this application asserts ownership of the clipboard.

  33.      *

  34.      * @param clipboard the clipboard that is no longer owned

  35.      * @param contents the contents which this owner had placed on the clipboard

  36.      */

  37.     public void lostOwnership(Clipboard clipboard, Transferable contents);

  38. 

  39. }