|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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() 获得此容器的布局管理器。 |
|
|
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.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
- 要获得的组件的索引。 - 返回:
- 此容器中的 nth 组件。
- 抛出:
-
ArrayIndexOutOfBoundsException
- 如果 nth 值不存在。
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()