java.awt
Class Container

java.lang.Object   
  java.awt.Component   
      java.awt.Container

All Implemented Interfaces:

ImageObserver , MenuContainer , Serializable

Direct Known Subclasses:

BasicSplitPaneDivider , CellRendererPane , DefaultTreeCellEditor.EditorContainer , JComponent , Panel , ScrollPane , Window

public class Container
extends Component   

A generic Abstract Window Toolkit(AWT) container object is a component that can contain other AWT components.

Components added to a container are tracked in a list. The order of the list will define the components' front-to-back stacking order within the container. If no index is specified when adding a component to a container, it will be added to the end of the list (and hence to the bottom of the stacking order).

Note: For details on the focus subsystem, see How to Use the Focus Subsystem, a section in The Java Tutorial, and the Focus Specification for more information.

Since:

JDK1.0

See Also:

add(java.awt.Component, int) , getComponent(int) , LayoutManager , Serialized Form

Nested Class Summary

protected class

Container.AccessibleAWTContainer Inner class of Container used to provide default support for accessibility.

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent , Component.BltBufferStrategy , Component.FlipBufferStrategy

Field Summary

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT , ALLBITS , ERROR , FRAMEBITS , HEIGHT , PROPERTIES , SOMEBITS , WIDTH

Constructor Summary

Container ()
Constructs a new Container.

Method Summary

Component	add (Component comp) Appends the specified component to the end of this container.
Component	add (Component comp, int index) Adds the specified component to this container at the given position.
void	add (Component comp, Object constraints) Adds the specified component to the end of this container.
void	add (Component comp, Object constraints, int index) Adds the specified component to this container with the specified constraints at the specified index.
Component	add (String name, Component comp) Adds the specified component to this container.
void	addContainerListener (ContainerListener l) Adds the specified container listener to receive container events from this container.
protected void	addImpl (Component comp, Object constraints, int index) Adds the specified component to this container at the specified index.
void	addNotify () Makes this Container displayable by connecting it to a native screen resource.
void	addPropertyChangeListener (PropertyChangeListener listener) Adds a PropertyChangeListener to the listener list.
void	addPropertyChangeListener (String propertyName, PropertyChangeListener listener) Adds a PropertyChangeListener to the listener list for a specific property.
void	applyComponentOrientation (ComponentOrientation o) Sets the ComponentOrientation property of this container and all components contained within it.
boolean	areFocusTraversalKeysSet (int id) Returns whether the Set of focus traversal keys for the given focus traversal operation has been explicitly defined for this Container.
int	countComponents () Deprecated. As of JDK version 1.1, replaced by getComponentCount().
void	deliverEvent (Event e) Deprecated. As of JDK version 1.1, replaced by dispatchEvent(AWTEvent e)
void	doLayout () Causes this container to lay out its components.
Component	findComponentAt (int x, int y) Locates the visible child component that contains the specified position.
Component	findComponentAt (Point p) Locates the visible child component that contains the specified point.
float	getAlignmentX () Returns the alignment along the x axis.
float	getAlignmentY () Returns the alignment along the y axis.
Component	getComponent (int n) Gets the nth component in this container.
Component	getComponentAt (int x, int y) Locates the component that contains the x,y position.
Component	getComponentAt (Point p) Gets the component that contains the specified point.
int	getComponentCount () Gets the number of components in this panel.
Component []	getComponents () Gets all the components in this container.
int	getComponentZOrder (Component comp) Returns the z-order index of the component inside the container.
ContainerListener []	getContainerListeners () Returns an array of all the container listeners registered on this container.
Set <AWTKeyStroke >	getFocusTraversalKeys (int id) Returns the Set of focus traversal keys for a given traversal operation for this Container.
FocusTraversalPolicy	getFocusTraversalPolicy () Returns the focus traversal policy that will manage keyboard traversal of this Container's children, or null if this Container is not a focus cycle root.
Insets	getInsets () Determines the insets of this container, which indicate the size of the container's border.
LayoutManager	getLayout () Gets the layout manager for this container.
<T extends EventListener > T[]	getListeners (Class <T> listenerType) Returns an array of all the objects currently registered as FooListeners upon this Container.
Dimension	getMaximumSize () Returns the maximum size of this container.
Dimension	getMinimumSize () Returns the minimum size of this container.
Point	getMousePosition (boolean allowChildren) Returns the position of the mouse pointer in this Container's coordinate space if the Container is under the mouse pointer, otherwise returns null.
Dimension	getPreferredSize () Returns the preferred size of this container.
Insets	insets () Deprecated. As of JDK version 1.1, replaced by getInsets().
void	invalidate () Invalidates the container.
boolean	isAncestorOf (Component c) Checks if the component is contained in the component hierarchy of this container.
boolean	isFocusCycleRoot () Returns whether this Container is the root of a focus traversal cycle.
boolean	isFocusCycleRoot (Container container) Returns whether the specified Container is the focus cycle root of this Container's focus traversal cycle.
boolean	isFocusTraversalPolicyProvider () Returns whether this container provides focus traversal policy.
boolean	isFocusTraversalPolicySet () Returns whether the focus traversal policy has been explicitly set for this Container.
void	layout () Deprecated. As of JDK version 1.1, replaced by doLayout().
void	list (PrintStream out, int indent) Prints a listing of this container to the specified output stream.
void	list (PrintWriter out, int indent) Prints out a list, starting at the specified indentation, to the specified print writer.
Component	locate (int x, int y) Deprecated. As of JDK version 1.1, replaced by getComponentAt(int, int).
Dimension	minimumSize () Deprecated. As of JDK version 1.1, replaced by getMinimumSize().
void	paint (Graphics g) Paints the container.
void	paintComponents (Graphics g) Paints each of the components in this container.
protected String	paramString () Returns a string representing the state of this Container.
Dimension	preferredSize () Deprecated. As of JDK version 1.1, replaced by getPreferredSize().
void	print (Graphics g) Prints the container.
void	printComponents (Graphics g) Prints each of the components in this container.
protected void	processContainerEvent (ContainerEvent e) Processes container events occurring on this container by dispatching them to any registered ContainerListener objects.
protected void	processEvent (AWTEvent e) Processes events on this container.
void	remove (Component comp) Removes the specified component from this container.
void	remove (int index) Removes the component, specified by index, from this container.
void	removeAll () Removes all the components from this container.
void	removeContainerListener (ContainerListener l) Removes the specified container listener so it no longer receives container events from this container.
void	removeNotify () Makes this Container undisplayable by removing its connection to its native screen resource.
void	setComponentZOrder (Component comp, int index) Moves the specified component to the specified z-order index in the container.
void	setFocusCycleRoot (boolean focusCycleRoot) Sets whether this Container is the root of a focus traversal cycle.
void	setFocusTraversalKeys (int id, Set <? extends AWTKeyStroke > keystrokes) Sets the focus traversal keys for a given traversal operation for this Container.
void	setFocusTraversalPolicy (