src/share/classes/java/awt/event/ComponentListener.java

Print this page




  29 
  30 /**
  31  * The listener interface for receiving component events.
  32  * The class that is interested in processing a component event
  33  * either implements this interface (and all the methods it
  34  * contains) or extends the abstract <code>ComponentAdapter</code> class
  35  * (overriding only the methods of interest).
  36  * The listener object created from that class is then registered with a
  37  * component using the component's <code>addComponentListener</code>
  38  * method. When the component's size, location, or visibility
  39  * changes, the relevant method in the listener object is invoked,
  40  * and the <code>ComponentEvent</code> is passed to it.
  41  * <P>
  42  * Component events are provided for notification purposes ONLY;
  43  * The AWT will automatically handle component moves and resizes
  44  * internally so that GUI layout works properly regardless of
  45  * whether a program registers a <code>ComponentListener</code> or not.
  46  *
  47  * @see ComponentAdapter
  48  * @see ComponentEvent
  49  * @see <a href="http://java.sun.com/docs/books/tutorial/post1.0/ui/componentlistener.html">Tutorial: Writing a Component Listener</a>
  50  *
  51  * @author Carl Quinn
  52  * @since 1.1
  53  */
  54 public interface ComponentListener extends EventListener {
  55     /**
  56      * Invoked when the component's size changes.
  57      */
  58     public void componentResized(ComponentEvent e);
  59 
  60     /**
  61      * Invoked when the component's position changes.
  62      */
  63     public void componentMoved(ComponentEvent e);
  64 
  65     /**
  66      * Invoked when the component has been made visible.
  67      */
  68     public void componentShown(ComponentEvent e);
  69 


  29 
  30 /**
  31  * The listener interface for receiving component events.
  32  * The class that is interested in processing a component event
  33  * either implements this interface (and all the methods it
  34  * contains) or extends the abstract <code>ComponentAdapter</code> class
  35  * (overriding only the methods of interest).
  36  * The listener object created from that class is then registered with a
  37  * component using the component's <code>addComponentListener</code>
  38  * method. When the component's size, location, or visibility
  39  * changes, the relevant method in the listener object is invoked,
  40  * and the <code>ComponentEvent</code> is passed to it.
  41  * <P>
  42  * Component events are provided for notification purposes ONLY;
  43  * The AWT will automatically handle component moves and resizes
  44  * internally so that GUI layout works properly regardless of
  45  * whether a program registers a <code>ComponentListener</code> or not.
  46  *
  47  * @see ComponentAdapter
  48  * @see ComponentEvent
  49  * @see <a href="http://docs.oracle.com/javase/tutorial/uiswing/events/componentlistener.html">Tutorial: Writing a Component Listener</a>
  50  *
  51  * @author Carl Quinn
  52  * @since 1.1
  53  */
  54 public interface ComponentListener extends EventListener {
  55     /**
  56      * Invoked when the component's size changes.
  57      */
  58     public void componentResized(ComponentEvent e);
  59 
  60     /**
  61      * Invoked when the component's position changes.
  62      */
  63     public void componentMoved(ComponentEvent e);
  64 
  65     /**
  66      * Invoked when the component has been made visible.
  67      */
  68     public void componentShown(ComponentEvent e);
  69