Container (Java 2 Platform SE v1.4.1)

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).

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 inherited from class java.awt.Component
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.
ContainerListener[] getContainerListeners()
    Returns an array of all the container listeners registered on this container.
Set 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.
EventListener[] getListeners(Class 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.
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 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 indention, 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 setFocusCycleRoot(boolean focusCycleRoot)
    Sets whether this Container is the root of a focus traversal cycle.
void setFocusTraversalKeys(int id, Set keystrokes)
    Sets the focus traversal keys for a given traversal operation for this Container.
void setFocusTraversalPolicy(FocusTraversalPolicy policy)
    Sets the focus traversal policy that will manage keyboard traversal of this Container's children, if this Container is a focus cycle root.
void setFont(Font f)
    Sets the font of this container.
void setLayout(LayoutManager mgr)
    Sets the layout manager for this container.
void transferFocusBackward()
    Transfers the focus to the previous component, as though this Component were the focus owner.
void transferFocusDownCycle()
    Transfers the focus down one focus traversal cycle.
void update(Graphics g)
    Updates the container.
void validate()
    Validates this container and all of its subcomponents.
protected void validateTree()
    Recursively descends the container tree and recomputes the layout for any subtrees marked as needing it (those marked as invalid).

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow,

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.
ContainerListener[]	getContainerListeners() Returns an array of all the container listeners registered on this container.
Set	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.
EventListener[]	getListeners(Class 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.
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	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 indention, 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	setFocusCycleRoot(boolean focusCycleRoot) Sets whether this Container is the root of a focus traversal cycle.
void	setFocusTraversalKeys(int id, Set keystrokes) Sets the focus traversal keys for a given traversal operation for this Container.
void	setFocusTraversalPolicy(FocusTraversalPolicy policy) Sets the focus traversal policy that will manage keyboard traversal of this Container's children, if this Container is a focus cycle root.
void	setFont(Font f) Sets the font of this container.
void	setLayout(LayoutManager mgr) Sets the layout manager for this container.
void	transferFocusBackward() Transfers the focus to the previous component, as though this Component were the focus owner.
void	transferFocusDownCycle() Transfers the focus down one focus traversal cycle.
void	update(Graphics g) Updates the container.
void	validate() Validates this container and all of its subcomponents.
protected void	validateTree() Recursively descends the container tree and recomputes the layout for any subtrees marked as needing it (those marked as invalid).

java.awt Class Container

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

java.awt
Class Container