java.awt

Class Container

java.lang.Object

java.awt.Component

java.awt.Container

All Implemented Interfaces:

ImageObserver ， MenuContainer ， Serializable

已知直接子类：

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

public class Container
extends Component

通用抽象窗口工具包（AWT）容器对象是可以包含其他AWT组件的组件。

添加到容器的组件将在列表中进行跟踪。 列表的顺序将在容器内定义组件的前后堆叠顺序。 如果在向容器添加组件时未指定索引，则将其添加到列表的末尾（因此将添加到堆栈顺序的底部）。

注意 ：有关焦点子系统的详细信息，请参阅How to Use the Focus Subsystem ，在Java教程一节，以及Focus Specification以获取更多信息。

从以下版本开始：

JDK1.0

另请参见：

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Container.AccessibleAWTContainer Container的内部类用于为辅助功能提供默认支持。

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class java.awt.Component

accessibleContext, 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 and Description
Container() 构造一个新的容器。

方法摘要

Modifier and Type	Method and Description
Component	add(Component comp) 将指定的组件附加到此容器的末尾。
Component	add(Component comp, int index) 在给定的位置将指定的组件添加到此容器。
void	add(Component comp, Object constraints) 将指定的组件添加到此容器的末尾。
void	add(Component comp, Object constraints, int index) 将指定的组件添加到指定索引处的指定约束的容器中。
Component	add(String name, Component comp) 将指定的组件添加到此容器。
void	addContainerListener(ContainerListener l) 添加指定的容器侦听器以从此容器接收容器事件。
protected void	addImpl(Component comp, Object constraints, int index) 在指定的索引处将指定的组件添加到此容器。
void	addNotify() 通过将此容器连接到本机屏幕资源来使此容器显示。
void	addPropertyChangeListener(PropertyChangeListener listener) 将PropertyChangeListener添加到侦听器列表。
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener) 将PropertyChangeListener添加到特定属性的侦听器列表中。
void	applyComponentOrientation(ComponentOrientation o) 设置此 ComponentOrientation属性及其中包含的所有组件。
boolean	areFocusTraversalKeysSet(int id) 返回是否为此容器显式定义了给定焦点遍历操作的聚焦遍历键集。
int	countComponents() 已弃用 从JDK 1.1版开始，由getComponentCount（）替换。
void	deliverEvent(Event e) 已弃用 截至JDK 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-order索引。
ContainerListener[]	getContainerListeners() 返回在此容器上注册的所有容器侦听器的数组。
Set<AWTKeyStroke>	getFocusTraversalKeys(int id) 返回此Container的给定遍历操作的聚焦遍历键集。
FocusTraversalPolicy	getFocusTraversalPolicy() 返回将管理此Container的子项的键盘遍历的焦点遍历策略，如果此Container不是焦点循环根，则返回null。
Insets	getInsets() 确定此容器的插入，这表示容器边框的大小。
LayoutManager	getLayout() 获取此容器的布局管理器。
<T extends EventListener> T[]	getListeners(类<T> listenerType) 返回当前注册为 FooListener的所有对象的数组，在此 Container 。
Dimension	getMaximumSize() 返回此容器的最大大小。
Dimension	getMinimumSize() 返回此容器的最小大小。
Point	getMousePosition(boolean allowChildren) 如果 Container位于鼠标指针下，则返回该指针位于该 Container的坐标空间中，否则返回 null 。
Dimension	getPreferredSize() 返回此容器的首选大小。
Insets	insets() 已弃用 从JDK 1.1版开始，由getInsets() 。
void	invalidate() 使容器无效。
boolean	isAncestorOf(Component c) 检查组件是否包含在此容器的组件层次结构中。
boolean	isFocusCycleRoot() 返回此容器是否是焦点遍历循环的根。
boolean	isFocusCycleRoot(Container container) 返回指定的Container是否是此Container的焦点遍历循环的焦点循环根。
boolean	isFocusTraversalPolicyProvider() 返回此容器是否提供焦点遍历策略。
boolean	isFocusTraversalPolicySet() 返回是否为此Container显式设置了重点遍历策略。
boolean	isValidateRoot() 指示此容器是否为 验证根 。
void	layout() 已弃用 从JDK 1.1版开始，由doLayout() 。
void	list(PrintStream out, int indent) 将此容器的列表打印到指定的输出流。
void	list(PrintWriter out, int indent) 从指定的缩进开始列出指定的打印作者的列表。
Component	locate(int x, int y) 已弃用 自JDK版本1.1起，由getComponentAt(int, int) 。
Dimension	minimumSize() 已弃用 截至JDK 1.1版，由getMinimumSize()取代。
void	paint(Graphics g) 涂上容器
void	paintComponents(Graphics g) 涂抹此容器中的每个组件。
protected String	paramString() 返回一个表示此 Container状态的字符串。
Dimension	preferredSize() 已弃用 从JDK 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() 通过删除其与其本机屏幕资源的连接，使此容器不可显示。
void	setComponentZOrder(Component comp, int index) 将指定的组件移动到容器中指定的z顺序索引。
void	setFocusCycleRoot(boolean focusCycleRoot) 设置此容器是否是焦点遍历循环的根。
void	setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes) 设置此容器的给定遍历操作的焦点遍历键。
void	setFocusTraversalPolicy(FocusTraversalPolicy policy) 设置焦点遍历策略，将管理此Container的子项的键盘遍历，如果此Container是焦点循环根。
void	setFocusTraversalPolicyProvider(boolean provider) 设置此容器是否将用于提供焦点遍历策略。
void	setFont(Font f) 设置此容器的字体。
void	setLayout(LayoutManager mgr) 设置此容器的布局管理器。
void	transferFocusDownCycle() 将焦点转移到一个焦点遍历周期。
void	update(Graphics g) 更新容器。
void	validate() 验证此容器及其所有子组件。
protected void	validateTree() 递归地下降容器树，并重新计算标记为需要的任何子树（标记为无效的）的布局。

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, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBaseline, getBaselineResizeBehavior, 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, revalidate, 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, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

Container

public Container()

构造一个新的容器。 容器可以直接扩展，但在这种情况下是轻量级的，并且必须包含在本机组件树中较高的位置的父级。 （例如Frame）。

方法详细信息

getComponentCount

public int getComponentCount()

获取此面板中的组件数量。

注意：此方法应在AWT树锁下调用。

结果

该面板中的组件数量。

从以下版本开始：

JDK1.1

另请参见：

getComponent(int) ， Component.getTreeLock()

countComponents

@Deprecated
public int countComponents()

已弃用 从JDK 1.1版开始，由getComponentCount（）替换。

getComponent

public Component getComponent(int n)

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

注意：此方法应在AWT树锁下调用。

参数

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

结果

这个容器中的 ^第 n ^个组件。

异常

ArrayIndexOutOfBoundsException - 如果第n ^个值不存在。

另请参见：

Component.getTreeLock()

getComponents

public Component[] getComponents()

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

注意：此方法应在AWT树锁下调用。

结果

这个容器中的所有组件的数组。

另请参见：

Component.getTreeLock()

getInsets

public Insets getInsets()

确定此容器的插入，这表示容器边框的大小。

例如， Frame对象具有对应于框架标题栏的高度的顶部插入。

结果

这个容器的插图。

从以下版本开始：

JDK1.1

另请参见：

Insets ， LayoutManager

insets

@Deprecated
public Insets insets()

已弃用 截至JDK 1.1版，由getInsets()取代。

add

public Component add(Component comp)

将指定的组件附加到此容器的末尾。 这是一个方便的方法addImpl(java.awt.Component, java.lang.Object, int) 。

该方法更改布局相关信息，因此使组件层次结构无效。 如果容器已经被显示，则此后必须验证层次结构，以显示添加的组件。

参数

comp - 要添加的组件

结果

组件参数

异常

NullPointerException - 如果 comp是 null

另请参见：

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

add

public Component add(String name,
                     Component comp)

将指定的组件添加到此容器。 这是一个方便的方法addImpl(java.awt.Component, java.lang.Object, int) 。

这种方法从1.1开始就已经过时了。 请改用方法add(Component, Object) 。

该方法更改布局相关信息，因此使组件层次结构无效。 如果容器已经被显示，则此后必须验证层次结构，以显示添加的组件。

异常

NullPointerException - 如果 comp是 null

另请参见：

add(Component, Object) ， invalidate()

add

public Component add(Component comp,
                     int index)

在给定的位置将指定的组件添加到此容器。 这是一个方便的方法addImpl(java.awt.Component, java.lang.Object, int) 。

该方法更改布局相关信息，因此使组件层次结构无效。 如果容器已经被显示，则此后必须验证层次结构，以显示添加的组件。

参数

comp - 要添加的组件

index - 插入组件的位置，或 -1将组件附加到最后

结果

组件 comp

异常

NullPointerException - 如果 comp是 null

IllegalArgumentException - 如果 index无效（详见 addImpl(java.awt.Component, java.lang.Object, int) ）

另请参见：

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

setComponentZOrder

public void setComponentZOrder(Component comp,
                               int index)

将指定的组件移动到容器中指定的z顺序索引。 z次序确定组件被绘制的顺序; 首先使用最高z阶涂料的组分，最后使用最低z阶涂料的组分。 在组件重叠的地方，具有较低z阶的组件涂覆在具有较高z阶的组件上。

如果组件是某个其他容器的子对象，则在添加到此容器之前将其从该容器中删除。 此方法与java.awt.Container.add(Component, int)之间的java.awt.Container.add(Component, int)在于，该方法不会在removeNotify上调用removeNotify ，同时将其从其先前的容器中删除，除非有必要，并且在底层本机窗口系统允许的情况下。 这样，如果组件具有键盘焦点，则在移动到新位置时会保持焦点。

此属性保证仅适用于轻型非Container组件。

该方法更改布局相关信息，因此使组件层次结构无效。

注意 ：并非所有平台都支持将重量级组件的z级从一个容器更改为另一个容器，而无需调用removeNotify 。 无法检测平台是否支持此功能，因此开发人员不应作出任何假设。

参数

comp - 要移动的组件

index - 容器列表中插入组件的位置，其中 getComponentCount()附加到最后

异常

NullPointerException - 如果 comp是 null

IllegalArgumentException - 如果 comp是容器的父母之一

IllegalArgumentException - 如果 index不在范围 [0, getComponentCount()]之间移动容器之间，或不在范围 [0, getComponentCount()-1]在 [0, getComponentCount()-1]内移动

IllegalArgumentException - 如果向其自身添加容器

IllegalArgumentException - 如果向 Window添加Window

从以下版本开始：

1.5

另请参见：

getComponentZOrder(java.awt.Component) ， invalidate()

getComponentZOrder

public int getComponentZOrder(Component comp)

返回容器内组件的z-order索引。 组件在z阶层次中越高，其索引越低。 最后一个z顺序索引最低的组件，最重要的是其他子组件。

参数

comp - 被查询的组件

结果

组件的z阶索引; 否则返回-1，如果组件是null或不属于容器

从以下版本开始：

1.5

另请参见：

setComponentZOrder(java.awt.Component, int)

add

public void add(Component comp,
                Object constraints)

将指定的组件添加到此容器的末尾。 还通知布局管理器使用指定的约束对象将组件添加到此容器的布局中。 这是一个方便的方法addImpl(java.awt.Component, java.lang.Object, int) 。

该方法更改布局相关信息，因此使组件层次结构无效。 如果容器已经被显示，则此后必须验证层次结构，以显示添加的组件。

参数

comp - 要添加的组件

constraints - 表示此组件的布局约束的对象

异常

NullPointerException - 如果 comp是 null

从以下版本开始：

JDK1.1

另请参见：

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

add

public void add(Component comp,
                Object constraints,
                int index)

将指定的组件添加到指定索引处的指定约束的容器中。 还通知布局管理器使用指定的约束对象将组件添加到此容器的布局。 这是一个方便的方法addImpl(java.awt.Component, java.lang.Object, int) 。

该方法更改布局相关信息，因此使组件层次结构无效。 如果容器已经被显示，则此后必须验证层次结构，以显示添加的组件。

参数

comp - 要添加的组件

constraints - 表示布局约束的对象

index - 容器列表中插入组件的位置; -1表示在末端组件插入

异常

NullPointerException - 如果 comp是 null

IllegalArgumentException - 如果 index无效（详见 addImpl(java.awt.Component, java.lang.Object, int) ）

另请参见：

addImpl(java.awt.Component, java.lang.Object, int) ， invalidate() ， validate() ， JComponent.revalidate() ， remove(int) ， LayoutManager

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

在指定的索引处将指定的组件添加到此容器。 此方法还通知布局管理器通过addLayoutComponent方法使用指定的约束对象将组件添加到此容器的布局。

约束由正在使用的特定布局管理器定义。 例如， BorderLayout类定义了五个约束： BorderLayout.NORTH ， BorderLayout.SOUTH ， BorderLayout.EAST ， BorderLayout.WEST和BorderLayout.CENTER 。

GridBagLayout类需要一个GridBagConstraints对象。 未能通过正确类型的约束对象结果在一个IllegalArgumentException 。

如果当前的布局管理器实现LayoutManager2 ，那么就调用LayoutManager2.addLayoutComponent(Component,Object) 。 如果当前的布局管理器不实现LayoutManager2 ，而约束是String ，那么LayoutManager.addLayoutComponent(String,Component)就被调用了。

如果组件不是此容器的祖先，并且具有非空父项，则在将其添加到此容器之前，它将从其当前父进程中删除。

如果程序需要跟踪每个添加到容器的请求，那么这种方法将会覆盖所有其他添加方法。 一个重写方法通常应该包括调用超类的方法版本：

super.addImpl(comp, constraints, index)

该方法更改布局相关信息，因此使组件层次结构无效。 如果容器已经被显示，则此后必须验证层次结构，以显示添加的组件。

参数

comp - 要添加的组件

constraints - 表示该组件的布局约束的对象

index - 容器列表中插入组件的位置，其中 -1表示附加到最后

异常

IllegalArgumentException - 如果index无效; 如果comp是该容器的小孩，则有效范围为[-1, getComponentCount()-1] ; 如果组件不是此容器的子级，则有效范围为[-1, getComponentCount()]

IllegalArgumentException - 如果 comp是此容器的祖先

IllegalArgumentException - 如果向 IllegalArgumentException添加窗口

NullPointerException - 如果 comp是 null

从以下版本开始：

JDK1.1

另请参见：

add(Component) ， add(Component, int) ， add(Component, java.lang.Object) ， invalidate() ， LayoutManager ， LayoutManager2

remove

public void remove(int index)

去除组件，通过指定index ，从这个容器。 此方法还会通过布局管理器通过removeLayoutComponent方法从该容器的布局中removeLayoutComponent 。

该方法更改布局相关信息，因此使组件层次结构无效。 如果已经显示了容器，则此后必须验证层次结构以反映更改。

参数

index - 要删除的组件的索引

异常

ArrayIndexOutOfBoundsException - 如果 index不在范围 [0, getComponentCount()-1]

从以下版本开始：

JDK1.1

另请参见：

add(java.awt.Component) ， invalidate() ， validate() ， getComponentCount()

remove

public void remove(Component comp)

从此容器中删除指定的组件。 此方法还通知布局管理器通过removeLayoutComponent方法从该容器的布局中removeLayoutComponent 。

该方法更改布局相关信息，因此使组件层次结构无效。 如果已经显示了容器，则此后必须验证层次结构以反映更改。

参数

comp - 要删除的组件

异常

NullPointerException - 如果 comp为 null

另请参见：

add(java.awt.Component) ， invalidate() ， validate() ， remove(int)

removeAll

public void removeAll()

从此容器中删除所有组件。 此方法还会通过布局管理器通过removeLayoutComponent方法从该容器的布局中removeLayoutComponent 。

该方法更改布局相关信息，因此使组件层次结构无效。 如果已经显示了容器，则此后必须验证层次结构以反映更改。

另请参见：

add(java.awt.Component) ， remove(int) ， invalidate()

getLayout

public LayoutManager getLayout()

获取此容器的布局管理器。

另请参见：

doLayout() ， setLayout(java.awt.LayoutManager)

setLayout

public void setLayout(LayoutManager mgr)

设置此容器的布局管理器。

该方法更改布局相关信息，因此使组件层次结构无效。

参数

mgr - 指定的布局管理器

另请参见：

doLayout() ， getLayout() ， invalidate()

doLayout

public void doLayout()

使此容器布置其组件。 大多数程序不应该直接调用此方法，而应调用validate方法。

重写：

doLayout在类别 Component

从以下版本开始：

JDK1.1

另请参见：

LayoutManager.layoutContainer(java.awt.Container) ， setLayout(java.awt.LayoutManager) ， validate()

layout

@Deprecated
public void layout()

已弃用 从JDK 1.1版开始，由doLayout() 。

重写：

layout在类别 Component

isValidateRoot

public boolean isValidateRoot()

指示此容器是否为验证根 。

布局相关的更改（例如验证根后代的边界）不会影响验证根父的布局。 当方法遇到有效根时，这种特性使invalidate()方法能够停止使组件层次结构无效。 但是，为了保持向后兼容性，只有当java.awt.smartInvalidate系统属性值设置为true时， java.awt.smartInvalidate启用此新的优化行为。

如果组件层次结构包含有效的根，并且启用了新的优化的invalidate()行为，则必须在先前无效的组件的有效根上调用validate()方法，以便稍后恢复层次结构的有效性。 否则，应使用顶级容器（如Frame对象）调用validate()方法来恢复组件层次结构的有效性。

Window类和Applet类是AWT中的有效根。 Swing引入更多有效的根。

结果

该容器是否是有效的根

从以下版本开始：

1.7

另请参见：

invalidate() ， Component.invalidate() ， JComponent.isValidateRoot() ， JComponent.revalidate()

invalidate

public void invalidate()

使容器无效。

如果这个LayoutManager上安装的LayoutManager是一个LayoutManager2接口的实例，那么LayoutManager2.invalidateLayout(Container)方法被调用，它提供这个Container作为参数。

之后，此方法标记此容器无效，并使其祖先无效。 有关详细信息，请参阅Component.invalidate()方法。

重写：

invalidate在类别 Component

另请参见：

validate() ， layout() ， LayoutManager2

validate

public void validate()

验证此容器及其所有子组件。

验证容器意味着布置其子组件。 与布局相关的更改，例如设置组件的边界，或者向容器添加组件，会自动使容器无效。 请注意，容器的祖先也可能无效（详见Component.invalidate() ）。因此，要恢复层次结构的有效性，应在validate()结构的最上层无效容器上调用validate()方法。

验证容器可能是相当耗时的操作。 出于性能原因，开发人员可能推迟层次结构的验证，直到一组布局相关的操作完成，例如在将所有子项添加到容器之后。

如果这个Container无效，此方法调用validateTree方法，并标记为Container为有效。 否则，不执行任何操作。

重写：

validate在类别 Component

另请参见：

add(java.awt.Component) ， invalidate() ， isValidateRoot() ， JComponent.revalidate() ， validateTree()

validateTree

protected void validateTree()

递归地下降容器树，并重新计算标记为需要的任何子树（标记为无效的）的布局。 应该通过调用此方法的方法提供validate ： validate 。

另请参见：

doLayout() ， validate()

setFont

public void setFont(Font f)

设置此容器的字体。

该方法更改布局相关信息，因此使组件层次结构无效。

重写：

setFont在 Component

参数

f - 成为此容器字体的字体。

从以下版本开始：

JDK1.0

另请参见：

Component.getFont() ， invalidate()

getPreferredSize

public Dimension getPreferredSize()

返回此容器的首选大小。 如果优选大小并没有被明确设置Component.setPreferredSize(Dimension)和这个Container具有non-null LayoutManager ，则LayoutManager.preferredLayoutSize(Container)被用来计算最佳尺寸。

注意：一些实现可以缓存从LayoutManager返回的值。 该缓存不需要调用实现preferredLayoutSize在LayoutManager每次调用此方法，而时间LayoutManager后才会进行查询Container变得无效。

重写：

getPreferredSize在类别 Component

结果

一个 Dimension此容器的首选大小的实例Dimension。

另请参见：

getMinimumSize() ， getMaximumSize() ， getLayout() ， LayoutManager.preferredLayoutSize(Container) ， Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize()

已弃用 从JDK 1.1版开始，由getPreferredSize()取代。

重写：

preferredSize在类别 Component

getMinimumSize

public Dimension getMinimumSize()

返回此容器的最小大小。 如果最小尺寸还没有被明确设置Component.setMinimumSize(Dimension)这Container有non-null LayoutManager ，然后LayoutManager.minimumLayoutSize(Container)用于计算的最小尺寸。

注意：某些实现可以缓存从LayoutManager返回的值。 该缓存不需要调用实现minimumLayoutSize在LayoutManager每次调用此方法，而时间LayoutManager后才会进行查询Container变得无效。

重写：

getMinimumSize在类别 Component

结果

一个 Dimension此容器的最小大小的实例Dimension。

从以下版本开始：

JDK1.1

另请参见：

getPreferredSize() ， getMaximumSize() ， getLayout() ， LayoutManager.minimumLayoutSize(Container) ， Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize()

已弃用 截至JDK 1.1版，由getMinimumSize()取代。

重写：

minimumSize在类别 Component

getMaximumSize

public Dimension getMaximumSize()

返回此容器的最大大小。 如果最大尺寸没有被明确设置Component.setMaximumSize(Dimension)和LayoutManager安装在此Container是的一个实例LayoutManager2 ，然后LayoutManager2.maximumLayoutSize(Container)用于计算的最大尺寸。

注意：一些实现可以缓存从LayoutManager2返回的值。 该缓存不需要调用实现maximumLayoutSize在LayoutManager2每次调用此方法，而时间LayoutManager2后才会进行查询Container变得无效。

重写：

getMaximumSize在类别 Component

结果

一个 Dimension此容器的最大大小的实例Dimension。

另请参见：

getPreferredSize() ， getMinimumSize() ， getLayout() ， LayoutManager2.maximumLayoutSize(Container) ， Component.getMaximumSize()

getAlignmentX

public float getAlignmentX()

返回沿x轴的对齐方式。 这指定了组件如何相对于其他组件进行对齐。 该值应为0到1之间的数字，其中0表示原点对齐，1对齐最远离原点，0.5为中心等。

重写：

getAlignmentX在类别 Component

getAlignmentY

public float getAlignmentY()

返回沿着y轴的对齐。 这指定了组件如何相对于其他组件进行对齐。 该值应为0到1之间的数字，其中0表示原点对齐，1对齐最远离原点，0.5为中心等。

重写：

getAlignmentY在类别 Component

paint

public void paint(Graphics g)

涂上容器 这会将油漆转移到任何这个容器的小孩的轻量级组件。 如果重新实现此方法，则应调用super.paint（g），以便轻量级组件正确呈现。 如果一个子组件被当前的剪裁设置（g）全部剪除，那么paint（）将不会转发给该小孩。

重写：

paint在类别 Component

参数

g - 指定的图形窗口

另请参见：

Component.update(Graphics)

update

public void update(Graphics g)

更新容器。 这将更新转发给任何作为此容器的子级的轻量级组件。 如果重新实现此方法，则应调用super.update（g），以便轻量级组件正确呈现。 如果子组件被目前的削减设置（g）修剪完毕，则update（）不会被转发给该小孩。

重写：

update在类别 Component

参数

g - 指定的图形窗口

另请参见：

Component.update(Graphics)

print

public void print(Graphics g)

打印容器。 这将打印转发到任何这个容器的孩子的轻量级组件。 如果重新实现此方法，则应调用super.print（g），以便正确渲染轻量级组件。 如果子组件完全被g中的剪切设置所限制，则print（）将不会转发给该小孩。

重写：

print在类别 Component

参数

g - 指定的图形窗口

另请参见：

Component.update(Graphics)

paintComponents

public void paintComponents(Graphics g)

涂抹此容器中的每个组件。

参数

g - 图形上下文。

另请参见：

Component.paint(java.awt.Graphics) ， Component.paintAll(java.awt.Graphics)

printComponents

public void printComponents(Graphics g)

打印此容器中的每个组件。

参数

g - 图形上下文。

另请参见：

Component.print(java.awt.Graphics) ， Component.printAll(java.awt.Graphics)

addContainerListener

public void addContainerListener(ContainerListener l)

添加指定的容器侦听器以从此容器接收容器事件。 如果l为空，则不会抛出任何异常，也不会执行任何操作。

请参阅AWT Threading Issues有关AWT的线程模型的细节。

参数

l - 容器侦听器

另请参见：

removeContainerListener(java.awt.event.ContainerListener) ， getContainerListeners()

removeContainerListener

public void removeContainerListener(ContainerListener l)

删除指定的容器侦听器，使其不再从此容器接收容器事件。 如果l为空，则不会抛出任何异常，也不会执行任何操作。

请参阅AWT Threading Issues有关AWT的线程模型的细节。

参数

l - 容器侦听器

另请参见：

addContainerListener(java.awt.event.ContainerListener) ， getContainerListeners()

getContainerListeners

public ContainerListener[] getContainerListeners()

返回在此容器上注册的所有容器侦听器的数组。

结果

所有这个容器的 ContainerListener s或一个空数组，如果没有容器侦听器当前注册

从以下版本开始：

1.4

另请参见：

addContainerListener(java.awt.event.ContainerListener) ， removeContainerListener(java.awt.event.ContainerListener)

getListeners

public <T extends EventListener> T[] getListeners(类<T> listenerType)

返回当前注册为FooListener的所有对象的数组，在此Container 。 FooListener使用addFooListener 。

您可以使用类文字指定listenerType参数，如FooListener.class 。 例如，您可以使用以下代码查询Container c其容器侦听器：

  ContainerListener[] cls = (ContainerListener[])(c.getListeners(ContainerListener.class)); 

如果没有这样的侦听器存在，这个方法返回一个空数组。

重写：

getListeners在类别 Component

参数

listenerType - 所请求的听众的类型; 此参数应指定从java.util.EventListener下降的java.util.EventListener

结果

在此容器上注册为 FooListener的所有对象的数组，如果没有添加此类侦听器，则为空数组

异常

ClassCastException - 如果 listenerType没有指定实现java.util.EventListener的类或 java.util.EventListener

NullPointerException - 如果 listenerType是 null

从以下版本开始：

1.3

另请参见：

getContainerListeners()

processEvent

protected void processEvent(AWTEvent e)

处理此容器上的事件。 如果事件是一个ContainerEvent ，它调用processContainerEvent方法，否则它调用其超类的processEvent 。

请注意，如果事件参数为null则行为未指定，可能会导致异常。

重写：

processEvent在类别 Component

参数

e - 事件

另请参见：

Component.processComponentEvent(java.awt.event.ComponentEvent) ， Component.processFocusEvent(java.awt.event.FocusEvent) ， Component.processKeyEvent(java.awt.event.KeyEvent) ， Component.processMouseEvent(java.awt.event.MouseEvent) ， Component.processMouseMotionEvent(java.awt.event.MouseEvent) ， Component.processInputMethodEvent(java.awt.event.InputMethodEvent) ， Component.processHierarchyEvent(java.awt.event.HierarchyEvent) ， Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)

processContainerEvent

protected void processContainerEvent(ContainerEvent e)

通过将容器事件发送到任何已注册的ContainerListener对象来处理容器事件。 注意：除非为此组件启用容器事件，否则不会调用此方法; 发生以下情况之一时：

• ContainerListener对象通过addContainerListener
• 集装箱事件通过enableEvents启用

请注意，如果事件参数为null则行为未指定，并可能导致异常。

参数

e - 容器事件

另请参见：

Component.enableEvents(long)

deliverEvent

@Deprecated
public void deliverEvent(Event e)

已弃用 从JDK 1.1版开始，由dispatchEvent(AWTEvent e)

重写：

deliverEvent在类别 Component

getComponentAt

public Component getComponentAt(int x,
                                int y)

找到包含x，y位置的组件。 在组件中存在重叠的情况下，返回最顶层的子组件。 这通过找到通过Component.contains（）声明包含给定点的索引0最接近的组件来确定，除了具有本机对等体的组件优先于不具有本机对等体的组件（即，轻量级组件）之外。

重写：

getComponentAt在类别 Component

参数

x - x坐标

y - y坐标

结果

如果组件不包含位置，则为null。 如果请求点没有子组件，并且该点在容器的边界内，则返回容器本身; 否则返回最顶端的孩子。

从以下版本开始：

JDK1.1

另请参见：

Component.contains(int, int)

locate

@Deprecated
public Component locate(int x,
                                    int y)

已弃用 从JDK 1.1版开始，由getComponentAt(int, int) 。

重写：

locate在类别 Component

getComponentAt

public Component getComponentAt(Point p)

获取包含指定点的组件。

重写：

getComponentAt在类别 Component

参数

p - 点。

结果

返回包含该点的 null如果组件不包含该点，则返回null。

从以下版本开始：

JDK1.1

另请参见：

Component.contains(int, int)

getMousePosition

public Point getMousePosition(boolean allowChildren)
                       throws HeadlessException

如果Container在鼠标指针下方，则返回鼠标指针位于此Container的坐标空间中，否则返回null 。 这种方法类似于Component.getMousePosition() ，除了它可以考虑Container的孩子。 如果allowChildren是false ，该方法将返回只有当鼠标指针位于上述一个非空值Container直接，不高于由儿童遮蔽的部分。 如果allowChildren是true ，如果鼠标指针高于Container或其任何true ，则此方法返回非空值。

参数

allowChildren - 如果孩子应该被考虑，则为真

结果

相对于此 Component鼠标坐标，或null

异常

HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true

从以下版本开始：

1.5

另请参见：

Component.getMousePosition()

findComponentAt

public Component findComponentAt(int x,
                                 int y)

找到包含指定位置的可见子组件。 在组件中存在重叠的情况下，返回最顶层的子组件。 如果包含子组件是容器，则此方法将继续搜索最深的嵌套子组件。 在搜索过程中忽略不可见的组件。

getComponentAt方法与getComponentAt不同，因为getComponentAt只搜索Container的直接子对象; 如果包含的组件是一个Container，那么findComponentAt将搜索该子节点以查找嵌套组件。

参数

x - x坐标

y - y坐标

结果

如果组件不包含位置，则为null。 如果在请求点没有子组件，并且该点在容器的边界内，则返回容器本身。

从以下版本开始：

1.2

另请参见：

Component.contains(int, int) ， getComponentAt(int, int)

findComponentAt

public Component findComponentAt(Point p)

找到包含指定点的可见子组件。 在组件中存在重叠的情况下，返回最顶层的子组件。 如果包含子组件是容器，则此方法将继续搜索最深的嵌套子组件。 在搜索过程中忽略不可见的组件。

getComponentAt方法与getComponentAt不同，因为getComponentAt只搜索Container的直接子对象; 如果包含的组件是一个Container，那么findComponentAt将搜索该子节点以查找嵌套组件。

参数

p - 点。

结果

如果组件不包含位置，则为null。 如果在请求点没有子组件，并且该点在容器的边界内，则返回容器本身。

异常

NullPointerException - 如果 p是 null

从以下版本开始：

1.2

另请参见：

Component.contains(int, int) ， getComponentAt(int, int)

addNotify

public void addNotify()

通过将此容器连接到本机屏幕资源来使此容器显示。 使容器显示可以使所有的孩子都可以显示。 该方法由工具包内部调用，不应由程序直接调用。

重写：

addNotify在类别 Component

另请参见：

Component.isDisplayable() ， removeNotify()

removeNotify

public void removeNotify()

通过删除其与其本机屏幕资源的连接，使此容器不可显示。 使容器不可显示将导致其所有的孩子都变得不可显示。 该方法在内部被工具包调用，不应该被程序直接调用。

重写：

removeNotify在类别 Component

另请参见：

Component.isDisplayable() ， addNotify()

isAncestorOf

public boolean isAncestorOf(Component c)

检查组件是否包含在此容器的组件层次结构中。

参数

c - 组件

结果

true如果是祖先; false否则。

从以下版本开始：

JDK1.1

paramString

protected String paramString()

返回一个表示此Container状态的字符串。 该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。

重写：

paramString在 Component

结果

该容器的参数字符串

list

public void list(PrintStream out,
                 int indent)

将此容器的列表打印到指定的输出流。 列表从指定的缩进开始。

容器的直接儿童印有indent+1的indent+1 。 这些孩子的孩子们打印在indent+2等等。

重写：

list在类别 Component

参数

out - 打印流

indent - 缩进的空格数

异常

NullPointerException - 如果 out是 null

从以下版本开始：

JDK1.0

另请参见：

Component.list(java.io.PrintStream, int)

list

public void list(PrintWriter out,
                 int indent)

从指定的缩进开始列出指定的打印作者的列表。

容器的直接儿童印有indent+1的indent+1 。 这些孩子的孩子们打印在indent+2等等。

重写：

list在类别 Component

参数

out - 打印作家

indent - 要缩进的空格数

异常

NullPointerException - 如果 out是 null

从以下版本开始：

JDK1.1

另请参见：

Component.list(java.io.PrintWriter, int)

setFocusTraversalKeys

public void setFocusTraversalKeys(int id,
                                  Set<? extends AWTKeyStroke> keystrokes)

设置此容器的给定遍历操作的焦点遍历键。

容器的焦点遍历键的默认值是依赖于实现的。 Sun建议特定本地平台的所有实现使用相同的默认值。 Windows和Unix的建议如下。 这些建议用于Sun AWT实现。

Identifier Meaning Default KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS Normal forward keyboard traversal TAB on KEY_PRESSED, CTRL-TAB on KEY_PRESSED KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS Normal reverse keyboard traversal SHIFT-TAB on KEY_PRESSED, CTRL-SHIFT-TAB on KEY_PRESSED KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS Go up one focus traversal cycle none KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS Go down one focus traversal cycle none 要禁用遍历键，请使用空的Set; 推荐使用Collections.EMPTY_SET。

使用AWTKeyStroke API，客户端代码可以指定两个特定的KeyEvent，KEY_PRESSED或KEY_RELEASED中的哪一个，焦点遍历操作将发生。 然而，无论指定了哪个KeyEvent，与焦点遍历密钥相关的所有KeyEvent都将被使用，包括关联的KEY_TYPED事件，并且不会被分派到任何Container。 指定一个KEY_TYPED事件作为映射到焦点遍历操作的运行时错误，或将同一事件映射到多个默认焦点遍历操作。

如果为Set指定了null值，则此Container将从其父项继承Set。 如果此容器的所有祖先对于Set指定了空值，则使用当前的KeyboardFocusManager的默认Set。

此方法可能会抛出一个ClassCastException如果Object在keystrokes不是AWTKeyStroke 。

重写：

setFocusTraversalKeys在类别 Component

参数

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS，KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS，KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS或KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS之一

keystrokes - 指定操作的AWTKeyStroke集

异常

IllegalArgumentException - 如果id不是KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS，KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS，KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS或KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS或KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS中的一个，或者如果键击包含null，或者如果任何键击代表KEY_TYPED事件，或者如果任何按键已映射到另一个焦点遍历此容器的操作

从以下版本开始：

1.4

另请参见：

getFocusTraversalKeys(int) ， KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS ， KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS ， KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS ， KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

getFocusTraversalKeys

public Set<AWTKeyStroke> getFocusTraversalKeys(int id)

返回此Container的给定遍历操作的聚焦遍历键集。 （有关每个键的完整说明，请参阅setFocusTraversalKeys ）

如果尚未为此Container显式定义一组遍历键，则返回此Container的父级Set。 如果没有为此Container的任何祖先显式定义Set，则返回当前的KeyboardFocusManager的默认Set。

重写：

getFocusTraversalKeys在类别 Component

参数

id - 一个KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS，KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS，KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS或KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

结果

指定操作的AWTKeyStrokes集。 该集将不可修改，可能为空。 将永远不会返回null。

异常

IllegalArgumentException - 如果id不是KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS，KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS，KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS或KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS中的一个

从以下版本开始：

1.4

另请参见：

setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>) ， KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS ， KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS ， KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS ， KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

返回是否为此容器显式定义了给定焦点遍历操作的聚焦遍历键集。 如果此方法返回false ，则此Container将从祖先或当前的KeyboardFocusManager继承Set。

重写：

areFocusTraversalKeysSet在 Component

参数

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS，KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS，KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS或KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS之一

结果

true如果为该组件明确定义了给定焦点遍历操作的聚焦遍历键集合; false否则。

异常

IllegalArgumentException - 如果id不是KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS之一，KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS，KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS或KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

从以下版本开始：

1.4

isFocusCycleRoot

public boolean isFocusCycleRoot(Container container)

返回指定的Container是否是此Container的焦点遍历循环的焦点循环根。 每个焦点遍历循环只有一个焦点循环根，而不是焦点循环根的每个容器只属于单个焦点遍历循环。 作为焦点循环根的容器属于两个循环：一个根据容器本身，一个根据容器最近的聚焦循环根祖先。 在这种情况下，这种方法将返回true这两个容器。

重写：

isFocusCycleRoot在类别 Component

参数

container - 要测试的容器

结果

true如果指定的Container是此Container的焦点循环根; false否则

从以下版本开始：

1.4

另请参见：

isFocusCycleRoot()

setFocusTraversalPolicy

public void setFocusTraversalPolicy(FocusTraversalPolicy policy)

设置焦点遍历策略，将管理此Container的子项的键盘遍历，如果此Container是焦点循环根。 如果参数为null，则此Container将从其focus-cycle-root祖先继承其策略。 如果参数为非空值，则该策略将被所有不具有自己的键盘遍历策略的focus-cycle-root子节点继承（递归地，它们的focus-cycle-root子句）。

如果此容器不是焦点循环根，则策略将被记住，但不会由此或任何其他容器使用或继承，直到此容器成为焦点循环根。

参数

policy - 此容器的新焦点遍历策略

从以下版本开始：

1.4

另请参见：

getFocusTraversalPolicy() ， setFocusCycleRoot(boolean) ， isFocusCycleRoot(java.awt.Container)

getFocusTraversalPolicy

public FocusTraversalPolicy getFocusTraversalPolicy()

返回将管理此Container的子项的键盘遍历的焦点遍历策略，如果此Container不是焦点循环根，则返回null。 如果没有为此Container显式设置遍历策略，则返回此Container的focus-cycle-root祖先的策略。

结果

此容器的焦点遍历策略，如果此Container不是焦点循环根，则为null。

从以下版本开始：

1.4

另请参见：

setFocusTraversalPolicy(java.awt.FocusTraversalPolicy) ， setFocusCycleRoot(boolean) ， isFocusCycleRoot(java.awt.Container)

isFocusTraversalPolicySet

public boolean isFocusTraversalPolicySet()

返回是否为此Container显式设置了重点遍历策略。 如果此方法返回false ，则此Container将从祖先继承其焦点遍历策略。

结果

true如果已经为此Container显式设置了焦点遍历策略; false否则。

从以下版本开始：

1.4

setFocusCycleRoot

public void setFocusCycleRoot(boolean focusCycleRoot)

设置此容器是否是焦点遍历循环的根。 一旦焦点进入遍历循环，通常不能通过焦点遍历离开它，除非按下了向上或向下循环键之一。 正常遍历仅限于此Container，并且所有这些Container的后代不是下焦点循环根的后代。 请注意，FocusTraversalPolicy可能会弯曲这些限制。 例如，ContainerOrderFocusTraversalPolicy支持隐式的下循环遍历。

指定此Container的子进程的遍历顺序的另一种方法是使此Container为focus traversal policy provider 。

参数

focusCycleRoot - 表示此容器是否是焦点遍历循环的根

从以下版本开始：

1.4

另请参见：

isFocusCycleRoot() ， setFocusTraversalPolicy(java.awt.FocusTraversalPolicy) ， getFocusTraversalPolicy() ， ContainerOrderFocusTraversalPolicy ， setFocusTraversalPolicyProvider(boolean)

isFocusCycleRoot

public boolean isFocusCycleRoot()

返回此容器是否是焦点遍历循环的根。 一旦焦点进入遍历循环，通常不能通过焦点遍历离开它，除非按下了向上或向下循环键之一。 正常遍历仅限于此Container，并且所有这些Container的后代不是下焦点循环根的后代。 请注意，FocusTraversalPolicy可能会弯曲这些限制。 例如，ContainerOrderFocusTraversalPolicy支持隐式的下循环遍历。

结果

这个容器是否是焦点遍历循环的根

从以下版本开始：

1.4

另请参见：

setFocusCycleRoot(boolean) ， setFocusTraversalPolicy(java.awt.FocusTraversalPolicy) ， getFocusTraversalPolicy() ， ContainerOrderFocusTraversalPolicy

setFocusTraversalPolicyProvider

public final void setFocusTraversalPolicyProvider(boolean provider)

设置此容器是否将用于提供焦点遍历策略。 将使用此属性为true来获取焦点遍历策略，而不是最近的焦点循环根祖先。

参数

provider - 指示此容器是否将用于提供焦点遍历策略

从以下版本开始：

1.5

另请参见：

setFocusTraversalPolicy(java.awt.FocusTraversalPolicy) ， getFocusTraversalPolicy() ， isFocusTraversalPolicyProvider()

isFocusTraversalPolicyProvider

public final boolean isFocusTraversalPolicyProvider()

返回此容器是否提供焦点遍历策略。 如果此属性设置为true那么当键盘焦点管理器搜索容器层次结构以进行焦点遍历策略，并且在此属性为true或焦点循环根的任何其他容器之前遇到此容器时，将使用其焦点遍历策略而不是焦点循环根策略。

结果

true如果此容器提供焦点遍历策略， false false

从以下版本开始：

1.5

另请参见：

setFocusTraversalPolicy(java.awt.FocusTraversalPolicy) ， getFocusTraversalPolicy() ， setFocusCycleRoot(boolean) ， setFocusTraversalPolicyProvider(boolean)

transferFocusDownCycle

public void transferFocusDownCycle()

将焦点转移到一个焦点遍历周期。 如果此容器是焦点循环根，则将焦点所有者设置为此Container的默认组件以进行对焦，并将当前焦点循环根设置为此Container。 如果此Container不是焦点循环根，则不会发生焦点遍历操作。

从以下版本开始：

1.4

另请参见：

Component.requestFocus() ， isFocusCycleRoot(java.awt.Container) ， setFocusCycleRoot(boolean)

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation o)

设置此ComponentOrientation属性及其中包含的所有组件。

该方法更改布局相关信息，因此使组件层次结构无效。

重写：

applyComponentOrientation在类别 Component

参数

o - 此容器及其中包含的组件的新组件方向。

异常

NullPointerException - 如果 orientation为空。

从以下版本开始：

1.4

另请参见：

Component.setComponentOrientation(java.awt.ComponentOrientation) ， Component.getComponentOrientation() ， invalidate()

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

将PropertyChangeListener添加到侦听器列表。 监听器已注册到此类的所有绑定属性，包括以下内容：

• 这个容器的字体（“font”）
• 此容器的背景颜色（“背景”）
• 这个容器的前景色（“前景”）
• 这个集装箱的聚焦性（“可聚焦”）
• 此容器的焦点遍历键启用状态（“focusTraversalKeysEnabled”）
• 此容器的一组FORWARD_TRAVERSAL_KEYS（“forwardFocusTraversalKeys”）
• 此容器的一组BACKWARD_TRAVERSAL_KEYS（“backwardFocusTraversalKeys”）
• 这个容器的一套UP_CYCLE_TRAVERSAL_KEYS（“upCycleFocusTraversalKeys”）
• 这个容器的一套DOWN_CYCLE_TRAVERSAL_KEYS（“downCycleFocusTraversalKeys”）
• 这个容器的焦点遍历策略（“focusTraversalPolicy”）
• 这个容器的焦点循环根状态（“focusCycleRoot”）

请注意，如果此容器是继承绑定属性，则不会在继承的属性中更改事件时触发任何事件。

如果侦听器为空，则不会抛出异常，也不会执行任何操作。

重写：

addPropertyChangeListener在类别 Component

参数

listener - 要添加的PropertyChangeListener

另请参见：

Component.removePropertyChangeListener(java.beans.PropertyChangeListener) ， addPropertyChangeListener(java.lang.String,java.beans.PropertyChangeListener)

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)

将PropertyChangeListener添加到特定属性的侦听器列表中。 指定的属性可能是用户定义的，也可能是以下默认值之一：

• 这个容器的字体（“font”）
• 此容器的背景颜色（“背景”）
• 这个容器的前景色（“前景”）
• 这个集装箱的聚焦性（“可聚焦”）
• 此容器的焦点遍历键启用状态（“focusTraversalKeysEnabled”）
• 此容器的一组FORWARD_TRAVERSAL_KEYS（“forwardFocusTraversalKeys”）
• 此容器的一组BACKWARD_TRAVERSAL_KEYS（“backwardFocusTraversalKeys”）
• 这个容器的一套UP_CYCLE_TRAVERSAL_KEYS（“upCycleFocusTraversalKeys”）
• 这个容器的一套DOWN_CYCLE_TRAVERSAL_KEYS（“downCycleFocusTraversalKeys”）
• 这个容器的焦点遍历策略（“focusTraversalPolicy”）
• 这个容器的焦点循环根状态（“focusCycleRoot”）
• 该容器的焦点遍历策略提供者状态（“focusTraversalPolicyProvider”）
• 该容器的焦点遍历策略提供者状态（“focusTraversalPolicyProvider”）

请注意，如果此容器是继承绑定属性，则不会在继承的属性中更改事件时触发任何事件。

如果侦听器为空，则不会抛出异常，也不会执行任何操作。

重写：

addPropertyChangeListener在类别 Component

参数

propertyName - 上面列出的属性名称之一

listener - 要添加的PropertyChangeListener

另请参见：

addPropertyChangeListener(java.beans.PropertyChangeListener) ， Component.removePropertyChangeListener(java.beans.PropertyChangeListener)