javax.swing
Class JWindowjava.lang.Object | +--java.awt.Component | +--java.awt.Container | +--java.awt.Window | +--javax.swing.JWindow
- All Implemented Interfaces:
- Accessible, ImageObserver, MenuContainer, RootPaneContainer, Serializable
- public class JWindow
- extends Window
- implements Accessible, RootPaneContainer
A JWindow is a container that can be displayed anywhere on the user's desktop. It does not have the title bar, window-management buttons, or other trimmings associated with a JFrame, but it is still a "first-class citizen" of the user's desktop, and can exist anywhere on it.
The JWindow component contains a JRootPane as its only child. The contentPane should be the parent of any children of the JWindow. From the older java.awt.Window object you would normally do something like this:
window.add(child);However, using JWindow you would code:window.getContentPane().add(child);The same is true of setting LayoutManagers, removing components, listing children, etc. All these methods should normally be sent to the contentPane instead of the JWindow itself. The contentPane will always be non-null. Attempting to set it to null will cause the JWindow to throw an exception. The default contentPane will have a BorderLayout manager set on it.Please see the JRootPane documentation for a complete description of the contentPane, glassPane, and layeredPane components.
In a multi-screen environment, you can create a JWindow on a different screen device. See Window for more information.
For the keyboard keys used by this component in the standard Look and Feel (L&F) renditions, see the JWindow key assignments.
Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeansTM has been added to the java.beans package. Please see XMLEncoder.
- See Also:
- JRootPane
Nested Class Summary
protected class JWindow.AccessibleJWindow
This class implements accessibility support for the JWindow class.
Nested classes inherited from class java.awt.Window
Nested classes inherited from class java.awt.Container
Nested classes inherited from class java.awt.Component Component.BltBufferStrategy, Component.FlipBufferStrategy
Field Summary
protected AccessibleContext accessibleContext
The accessible context property.protected JRootPane rootPane
The JRootPane instance that manages the contentPane and optional menuBar for this frame, as well as the glassPane.protected boolean rootPaneCheckingEnabled
If true then calls to add and setLayout will cause an exception to be thrown.
Fields inherited from class java.awt.Component 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 Summary
JWindow()
Creates a window with no specified owner.JWindow(Frame owner)
Creates a window with the specified owner frame.JWindow(GraphicsConfiguration gc)
Creates a window with the specified GraphicsConfiguration of a screen device.JWindow(Window owner)
Creates a window with the specified owner window.JWindow(Window owner, GraphicsConfiguration gc)
Creates a window with the specified owner window and GraphicsConfiguration of a screen device.
Method Summary
protected void addImpl(Component comp, Object constraints, int index)
By default, children may not be added directly to a this component, they must be added to its contentPane instead.protected JRootPane createRootPane()
Called by the constructor methods to create the default rootPane.AccessibleContext getAccessibleContext()
Gets the AccessibleContext associated with this JWindow.Container getContentPane()
Returns the Container which is the contentPane for this window.Component getGlassPane()
Returns the glassPane Component for this window.JLayeredPane getLayeredPane()
Returns the layeredPane object for this window.JRootPane getRootPane()
Returns the rootPane object for this window.protected boolean isRootPaneCheckingEnabled()
Returns whether calls to add and setLayout will cause an exception to be thrown.protected String paramString()
Returns a string representation of this JWindow.void remove(Component comp)
Removes the specified component from this container.void setContentPane(Container contentPane)
Sets the contentPane property for this window.void setGlassPane(Component glassPane)
Sets the glassPane property.void setLayeredPane(JLayeredPane layeredPane)
Sets the layeredPane property.void setLayout(LayoutManager manager)
By default the layout of this component may not be set, the layout of its contentPane should be set instead.protected void setRootPane(JRootPane root)
Sets the new rootPane object for this window.protected void setRootPaneCheckingEnabled(boolean enabled)
Determines whether calls to add and setLayout will cause an exception to be thrown.void update(Graphics g)
Calls paint(g).protected void windowInit()
Called by the constructors to init the JWindow properly.