-
- All Known Implementing Classes:
- JApplet, JDialog, JFrame, JInternalFrame, JWindow
public interface RootPaneContainer
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 asframe.getContentPane().add(child)
.For conveniance
JFrame
,JDialog
,JWindow
,JApplet
andJInternalFrame
, by default, forward, by default, all calls to theadd
,remove
andsetLayout
methods, to thecontentPane
. This means you can call:rootPaneContainer.add(component);
instead of:rootPaneContainer.getContentPane().add(component);
The behavior of the
add
andsetLayout
methods forJFrame
,JDialog
,JWindow
,JApplet
andJInternalFrame
is controlled by therootPaneCheckingEnabled
property. If this property is true (the default), then calls to these methods are forwarded to thecontentPane
; if false, these methods operate directly on theRootPaneContainer
. This property is only intended for subclasses, and is therefore protected.
-
-
Method Summary
Methods Modifier and Type Method and Description Container
getContentPane()
Returns the contentPane.Component
getGlassPane()
Returns the glassPane.JLayeredPane
getLayeredPane()
Returns the layeredPane.JRootPane
getRootPane()
Return this component's single JRootPane child.void
setContentPane(Container contentPane)
The "contentPane" is the primary container for application specific components.void
setGlassPane(Component glassPane)
The glassPane is always the first child of the rootPane and the rootPanes layout manager ensures that it's always as big as the rootPane.void
setLayeredPane(JLayeredPane layeredPane)
A Container that manages the contentPane and in some cases a menu bar.
-
-
-
Method Detail
-
getRootPane
JRootPane getRootPane()
Return this component's single JRootPane child. A conventional implementation of this interface will have all of the other methods indirect through this one. The rootPane has two children: the glassPane and the layeredPane.- Returns:
- this components single JRootPane child.
- See Also:
JRootPane
-
setContentPane
void setContentPane(Container contentPane)
The "contentPane" is the primary container for application specific components. Applications should add children to the contentPane, set its layout manager, and so on.The contentPane may not be null.
Generally implemented with
getRootPane().setContentPane(contentPane);
- Parameters:
contentPane
- the Container to use for the contents of this JRootPane- Throws:
IllegalComponentStateException
- (a runtime exception) if the content pane parameter is null- See Also:
JRootPane.getContentPane()
,getContentPane()
-
getContentPane
Container getContentPane()
Returns the contentPane.- Returns:
- the value of the contentPane property.
- See Also:
setContentPane(java.awt.Container)
-
setLayeredPane
void setLayeredPane(JLayeredPane layeredPane)
A Container that manages the contentPane and in some cases a menu bar. The layeredPane can be used by descendants that want to add a child to the RootPaneContainer that isn't layout managed. For example an internal dialog or a drag and drop effect component.The layeredPane may not be null.
Generally implemented with
getRootPane().setLayeredPane(layeredPane);
- Throws:
IllegalComponentStateException
- (a runtime exception) if the layered pane parameter is null- See Also:
getLayeredPane()
,JRootPane.getLayeredPane()
-
getLayeredPane
JLayeredPane getLayeredPane()
Returns the layeredPane.- Returns:
- the value of the layeredPane property.
- See Also:
setLayeredPane(javax.swing.JLayeredPane)
-
setGlassPane
void setGlassPane(Component glassPane)
The glassPane is always the first child of the rootPane and the rootPanes layout manager ensures that it's always as big as the rootPane. By default it's transparent and not visible. It can be used to temporarily grab all keyboard and mouse input by adding listeners and then making it visible. by default it's not visible.The glassPane may not be null.
Generally implemented with
getRootPane().setGlassPane(glassPane);
-
getGlassPane
Component getGlassPane()
Returns the glassPane.- Returns:
- the value of the glassPane property.
- See Also:
setGlassPane(java.awt.Component)
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/11/2024 22:03:09 Cette version de la page est en cache (à la date du 21/11/2024 22:03:09) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 31/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/swing/rootpanecontainer.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.