JavaTM 2 Platform
Standard Ed. 5.0

java.awt.event
Interface ContainerListener

All Superinterfaces:
EventListener
All Known Implementing Classes:
AWTEventMulticaster, BasicToolBarUI.ToolBarContListener, Container.AccessibleAWTContainer.AccessibleContainerHandler, ContainerAdapter, JComponent.AccessibleJComponent.AccessibleContainerHandler, MetalToolBarUI.MetalContainerListener

public interface ContainerListener
extends EventListener

The listener interface for receiving container events. The class that is interested in processing a container event either implements this interface (and all the methods it contains) or extends the abstract ContainerAdapter class (overriding only the methods of interest). The listener object created from that class is then registered with a component using the component's addContainerListener method. When the container's contents change because a component has been added or removed, the relevant method in the listener object is invoked, and the ContainerEvent is passed to it.

Container events are provided for notification purposes ONLY; The AWT will automatically handle add and remove operations internally so the program works properly regardless of whether the program registers a ComponentListener or not.

Since:
1.1
See Also:
ContainerAdapter, ContainerEvent, Tutorial: Writing a Container Listener, Reference: The Java Class Libraries (update file)

Method Summary
 void componentAdded(ContainerEvent e)
          Invoked when a component has been added to the container.
 void componentRemoved(ContainerEvent e)
          Invoked when a component has been removed from the container.
 

Method Detail

componentAdded

void componentAdded(ContainerEvent e)
Invoked when a component has been added to the container.


componentRemoved

void componentRemoved(ContainerEvent e)
Invoked when a component has been removed from the container.


JavaTM 2 Platform
Standard Ed. 5.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.