1. /*
  2. * @(#)ItemListener.java 1.13 00/02/02
  3. *
  4. * Copyright 1996-2000 Sun Microsystems, Inc. All Rights Reserved.
  5. *
  6. * This software is the proprietary information of Sun Microsystems, Inc.
  7. * Use is subject to license terms.
  8. *
  9. */
  10. package java.awt.event;
  11. import java.util.EventListener;
  12. /**
  13. * The listener interface for receiving item events.
  14. * The class that is interested in processing an item event
  15. * implements this interface. The object created with that
  16. * class is then registered with a component using the
  17. * component's <code>addItemListener</code> method. When an
  18. * item-selection event occurs, the listener object's
  19. * <code>itemStateChanged</code> method is invoked.
  20. *
  21. * @author Amy Fowler
  22. * @version 1.13 02/02/00
  23. *
  24. * @see ItemSelectable
  25. * @see ItemEvent
  26. * @see <a href="http://java.sun.com/docs/books/tutorial/post1.0/ui/itemlistener.html">Tutorial: Writing an Item Listener</a>
  27. * @see <a href="http://www.awl.com/cp/javaseries/jcl1_2.html">Reference: The Java Class Libraries (update file)</a>
  28. *
  29. * @since 1.1
  30. */
  31. public interface ItemListener extends EventListener {
  32. /**
  33. * Invoked when an item has been selected or deselected.
  34. * The code written for this method performs the operations
  35. * that need to occur when an item is selected (or deselected).
  36. */
  37. void itemStateChanged(ItemEvent e);
  38. }