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. package java.awt.datatransfer;
  8. /**
  9. * Defines the interface for classes that will provide data to
  10. * a clipboard. An instance of this interface becomes the owner
  11. * of the contents of a clipboard (clipboard owner) if it is
  12. * passed as an argument to
  13. * {@link java.awt.datatransfer.Clipboard#setContents} method of
  14. * the clipboard and this method returns successfully.
  15. * The instance remains the clipboard owner until another application
  16. * or another object within this application asserts ownership
  17. * of this clipboard.
  18. *
  19. * @see java.awt.datatransfer.Clipboard
  20. *
  21. * @version 1.11, 12/19/03
  22. * @author Amy Fowler
  23. */
  24. public interface ClipboardOwner {
  25. /**
  26. * Notifies this object that it is no longer the clipboard owner.
  27. * This method will be called when another application or another
  28. * object within this application asserts ownership of the clipboard.
  29. *
  30. * @param clipboard the clipboard that is no longer owned
  31. * @param contents the contents which this owner had placed on the clipboard
  32. */
  33. public void lostOwnership(Clipboard clipboard, Transferable contents);
  34. }