javax.swing
类 JRootPane

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JRootPane

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible

public class JRootPane
     

      extends 
      JComponent
     
     

      implements 
      Accessible
     

该轻量级容器由 JFrame、JDialog、JWindow、JApplet 和 JInternalFrame 在后台使用。有关根窗格所提供功能的面向任务的信息，请参阅 The Java Tutorial 中的 How to Use Root Panes 一节。

下面的图像显示了使用根窗格的各个类之间的关系。

注：使用 JComponent 的 getRootPane 方法可获取包含给定组件的 JRootPane。

尽管 menuBar 组件为可选，但 layeredPane、contentPane 和 glassPane 总是存在的。试图将它们设置为 null 将生成异常。

要将组件添加到 JRootPane（可选的菜单栏除外），您可以将对象添加到 JRootPane 的 contentPane，如下所示：

       rootPane.getContentPane().add(child);
 

注： contentPane 的默认布局管理器是 BorderLayout 管理器。但是， JRootPane 使用一个自定义的 LayoutManager。所以，如果您希望更改已添加到 JRootPane 中的组件的布局管理器，一定要确保使用如下代码：

    rootPane.getContentPane().setLayout(new BoxLayout());
 

layeredPane 是 JRootPane 中所有子级的父级，既是菜单的直接父级，又是添加到 contentPane 中的所有组件的祖父级。它是 JLayeredPane 的实例，提供在若干层上添加组件的能力。在处理弹出菜单、对话框以及拖动时，即要求将组件置于窗格中所有其它组件之上的情况下，此功能非常有用。

glassPane 位于 JRootPane 中所有其它组件之上。这为在所有其它组件上绘图和截取鼠标事件提供了方便，这对拖动和绘图都非常有用。开发人员可在 glassPane 上使用 setVisible 控制 glassPane 在所有其它子级上面显示的时间。默认情况下，glassPane 为不可见。

JRootPane 所使用的自定义 LayoutManager 可确保：

1. glassPane 填充了 JRootPane 的整个可查看区域（边界 - insets）。
2. layeredPane 填充了 JRootPane 的整个可查看区域。（边界 - insets）
3. menuBar 位于 layeredPane 的上边缘。
4. contentPane 填充了整个可查看区域，减去 menuBar（如果有）。

如果您替换 JRootPane 的 LayoutManager，您将负责管理所有这些视图。所以通常情况下，应该确保更改的是 contentPane 的布局管理器，而不是 JRootPane 自身的布局管理器。

Swing 的绘制架构要求在所有其它组件之上的包含层次结构中有一个不透明的 JComponent。这通常通过使用内容窗格来实现。如果要替换内容窗格，建议使用 setOpaque(true) 将内容窗格设置为不透明。另外，如果内容窗格重写 paintComponent，还需要在 paintComponent 中用不透明颜色将背景完全填充。

警告：Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：

JLayeredPane, JMenuBar, JWindow, JFrame, JDialog, JApplet, JInternalFrame, JComponent, BoxLayout, Mixing Heavy and Light Components