Java java.awt 类 Container（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.awt
类 Container

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

所有已实现的接口：

ImageObserver, MenuContainer, Serializable

直接已知子类：

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

---

public class Container
   
   
   
   
   
extends Component
   
   
   
   
   

一般的 Abstract Window Toolkit(AWT) 容器对象是一个可包含其他 AWT 组件的组件。

添加到容器中的组件放在一个列表中。列表的顺序将定义组件在容器内的正向堆栈顺序。如果将组件添加到容器中时未指定索引，则该索引将被添加到列表尾部（此后它位于堆栈顺序的底部）。

注：关于焦点子系统的细节信息，请参阅《The Java Tutorial》中 How to Use the Focus Subsystem 一节，要获得更多的信息，请参阅 Focus Specification。

从以下版本开始：

JDK1.0

另请参见：

add(java.awt.Component, int), getComponent(int), LayoutManager, 序列化表格

---

嵌套类摘要
protected  class	Container.AccessibleAWTContainer           用于对可访问性提供默认支持的 Container 内部类。

 

从类 java.awt.Component 继承的嵌套类/接口
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

 

字段摘要

 

从类 java.awt.Component 继承的字段
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

 

从接口 java.awt.image.ImageObserver 继承的字段
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

 

构造方法摘要
Container()           构造一个新的 Container。

 

方法摘要
Component	add(Component comp)           将指定组件追加到此容器的尾部。
Component	add(Component comp, int index)           将指定组件添加到此容器的给定位置上。
void	add(Component comp, Object constraints)           将指定的组件添加到此容器的尾部。
void	add(Component comp, Object constraints, int index)           使用指定约束 (Constraints)，将指定组件添加到此容器的指定索引所在的位置上。
Component	add(String name, Component comp)           将指定组件添加到此容器中。
void	addContainerListener(ContainerListener l)           添加指定容器的侦听器，以接收来自此容器的容器事件。
protected  void	addImpl(Component comp, Object constraints, int index)           将指定组件添加到此容器的指定索引所在的位置上。
void	addNotify()           通过将这个 Container 连接到本机屏幕资源，使其可以显示。
void	addPropertyChangeListener(PropertyChangeListener listener)           将一个 PropertyChangeListener 添加到侦听器列表中。
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener)           将一个 PropertyChangeListener 添加到某个指定属性的侦听器列表中。
void	applyComponentOrientation(ComponentOrientation o)           设置此容器和其中包含的所有组件的 ComponentOrientation 属性。
boolean	areFocusTraversalKeysSet(int id)           返回是否已经为此 Container 明确定义了用于给定焦点遍历操作的焦点遍历键的 Set。
int	countComponents()           已过时。 从 JDK version 1.1 开始，用 etComponentCount() 取代。
void	deliverEvent(Event e)           已过时。 从 JDK version 1.1 开始，用 dispatchEvent(AWTEvent e) 取代
void	doLayout()           使此容器布置其组件。
Component	findComponentAt(int x, int y)           对包含指定位置的可视子组件进行定位。
Component	findComponentAt(Point p)           对包含指定点的可视子组件进行定位。
float	getAlignmentX()           返回沿 x 轴的对齐方式。
float	getAlignmentY()           返回沿 y 轴的对齐方式。
Component	getComponent(int n)           获得此容器中的第 n 个组件。
Component	getComponentAt(int x, int y)           对包含 x，y 位置的组件进行定位。
Component	getComponentAt(Point p)           获得包含指定点的组件。
int	getComponentCount()           获得此面板中的组件数。
Component[]	getComponents()           获得此容器中的所有组件。
int	getComponentZOrder(Component comp)           返回容器内组件的 z 顺序索引。
ContainerListener[]	getContainerListeners()           返回已在此容器上注册的所有容器侦听器的数组。
Set<AWTKeyStroke>	getFocusTraversalKeys(int id)           为此 Container 的给定遍历操作返回焦点遍历键的 Set。
FocusTraversalPolicy	getFocusTraversalPolicy()           返回焦点遍历策略，用于管理此 Container 子组件的键盘遍历。
Insets	getInsets()           确定此容器的 insets，它指示容器边界 (border) 的大小。
LayoutManager	getLayout()           获得此容器的布局管理器。
<T extends EventListener> T[]	getListeners(Class<T> listenerType)           返回已在此 Container 上注册为 FooListener 的所有对象的数组。
Dimension	getMaximumSize()           返回此容器的最大大小。
Dimension	getMinimumSize()           返回此容器的最小大小。
Point	getMousePosition(boolean allowChildren)           如果 Container 位于鼠标指针下，则返回鼠标指针在此 Container 的坐标中的位置，否则返回 null。
Dimension	getPreferredSize()           返回此容器的首选大小。
Insets	insets()           已过时。 从 JDK version 1.1 开始，用 getInsets() 取代。
void	invalidate()           使容器失效。
boolean	isAncestorOf(Component c)           检查该组件是否包含在此容器的组件层次结构中。
boolean	isFocusCycleRoot()           返回此 Container 是否是某个焦点遍历循环的根。
boolean	isFocusCycleRoot(Container container)           返回指定的 Container 是否是此 Container 的焦点遍历循环的焦点循环根。
boolean	isFocusTraversalPolicyProvider()           返回此容器是否提供焦点遍历策略。
boolean	isFocusTraversalPolicySet()           返回是否为此 Container 明确设置焦点遍历策略。
void	layout()           已过时。 从 JDK version 1.1，用 doLayout() 取代。
void	list(PrintStream out, int indent)           将此容器的清单打印到指定输出流。
void	list(PrintWriter out, int indent)           将一个列表打印到指定打印编写器，从指定缩进位置开始。
Component	locate(int x, int y)           已过时。 从 JDK version 1.1 开始，用 getComponentAt(int, int) 取代。
Dimension	minimumSize()           已过时。 从 JDK version 1.1 开始，用 getMinimumSize() 取代。
void	paint(Graphics g)           绘制容器。
void	paintComponents(Graphics g)           绘制此容器中的每个组件。
protected  String	paramString()           返回表示此 Container 的状态的字符串。
Dimension	preferredSize()           已过时。 从 JDK version 1.1 开始，用 getPreferredSize() 取代。
void	print(Graphics g)           打印容器。
void	printComponents(Graphics g)           打印此容器中的每个组件。
protected  void	processContainerEvent(ContainerEvent e)           通过将发生在此容器上的容器事件指派给所有已注册的 ContainerListener 对象来处理这些事件。
protected  void	processEvent(AWTEvent e)           处理关于此容器的事件。
void	remove(Component comp)           从此容器中移除指定组件。
void	remove(int index)           从此容器中移除 index 指定的组件。
void	removeAll()           从此容器中移除所有组件。
void	removeContainerListener(ContainerListener l)           移除指定容器的侦听器，从而不再接收来自此容器的容器事件。
void	removeNotify()           通过移除此 Container 到其本机屏幕资源的连接，使其不可显示。
void	setComponentZOrder(Component comp, int index)           将指定组件移动到容器中指定的 z 顺序索引。
void	setFocusCycleRoot(boolean focusCycleRoot)           设置此 Container 是否是某个焦点遍历循环的根。
void	setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)           为此 Container 的给定遍历操作设置焦点遍历键。
void	setFocusTraversalPolicy(FocusTraversalPolicy policy)           设置将管理此 Container 的子代的键盘遍历的焦点遍历策略，如果此 Container 是一个焦点循环根。
void	setFocusTraversalPolicyProvider(boolean provider)           设置是否将用此容器提供焦点遍历策略。
void	setFont(Font f)           设置此容器的字体。
void	setLayout(LayoutManager mgr)           设置此容器的布局管理器。
void	transferFocusBackward()           将焦点转移到前一个组件，就好像此 Component 曾是焦点所有者。
void	transferFocusDownCycle()           将焦点向下传输一个焦点遍历循环。
void	update(Graphics g)           更新容器。
void	validate()           验证此容器及其所有子组件。
protected  void	validateTree()           递归继承容器树，对于所有被标记为需要重新计算布局的子树（标记为无效的那些子树）重新计算布局。

 

从类 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, firePropertyChange, firePropertyChange, firePropertyChange, 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, getMousePosition, 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, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, 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, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusUpCycle

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

 

构造方法详细信息

Container

public Container()

构造一个新的 Container。可以直接扩展 Container，但在这种情况下是轻量级的，并且它必须被位于本机组件树中更高处的某一个父容器包含。（比如说 Frame）。

方法详细信息

getComponentCount

public int getComponentCount()

获得此面板中的组件数。

返回：

此面板中的组件数。

从以下版本开始：

JDK1.1

另请参见：

getComponent(int)

---

countComponents

@Deprecated
public int countComponents()

已过时。 从 JDK version 1.1 开始，用 etComponentCount() 取代。

---

getComponent

public Component getComponent(int n)

获得此容器中的第 n 个组件。

参数：

n - 要获得的组件的索引。

返回：

此容器中的 n^th 组件。

抛出：

ArrayIndexOutOfBoundsException - 如果 n^th 值不存在。

---

getComponents

public Component[] getComponents()

获得此容器中的所有组件。

返回：

此容器中的所有组件的数组。

---

getInsets

public Insets getInsets()

确定此容器的 insets，它指示容器边界 (border) 的大小。

例如，Frame 对象有一个顶端 inset，它对应于 Frame（窗体）的标题栏的高度。

返回：

此容器的 inset。

从以下版本开始：

JDK1.1

另请参见：

Insets, LayoutManager

---

insets

@Deprecated
public Insets insets()

已过时。 从 JDK version 1.1 开始，用 getInsets() 取代。

---

add

public Component add(Component comp)

将指定组件追加到此容器的尾部。这是一个适用于 addImpl(java.awt.Component, java.lang.Object, int) 的便捷方法。

注：如果已经将某个组件添加到显示的容器中，则必须在此容器上调用 validate，以显示新的组件。如果添加多个组件，那么可以在添加所有组件之后，通过只调用一次 validate 来提高效率。

参数：

comp - 要添加的组件

返回：

component 参数

另请参见：

addImpl(java.awt.Component, java.lang.Object, int), validate(), JComponent.revalidate()