javax.swing
Class JWindow

java.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.
 
Methods inherited from class java.awt.Window
addNotify, addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, finalize, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, hide, isActive, isFocusableWindow, isFocusCycleRoot, isFocused, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeW