This interface is implemented by components that have a single JRootPane child: JDialog, JFrame, JWindow, JApplet, JInternalFrame. The methods in this interface are just
covers for the JRootPane properties, e.g.
getContentPane() is generally implemented like this:
public Container getContentPane() { return getRootPane().getContentPane(); } This interface serves as a
marker for Swing GUI builders that need to treat components like JFrame, that contain a single JRootPane, specially. For example in a GUI builder, dropping a component on a RootPaneContainer would be interpreted as
frame.getContentPane().add(child).
As a convenience, the standard classes that implement this interface (such as {@code JFrame}, {@code JDialog}, {@code JWindow}, {@code JApplet}, and {@code JInternalFrame}) have their {@code add}, {@code remove}, and {@code setLayout} methods overridden, so that they delegate callsto the corresponding methods of the {@code ContentPane}. For example, you can add a child component to a frame as follows:
frame.add(child);
instead of:
frame.getContentPane().add(child);
The behavior of the add and setLayout methods for JFrame, JDialog, JWindow, JApplet and JInternalFrame is controlled by the rootPaneCheckingEnabled property. If this property is true (the default), then calls to these methods are forwarded to the contentPane; if false, these methods operate directly on the RootPaneContainer. This property is only intended for subclasses, and is therefore protected.
@see JRootPane
@see JFrame
@see JDialog
@see JWindow
@see JApplet
@see JInternalFrame
@author Hans Muller