javax.swing

Class JWindow

Implemented Interfaces:
Accessible, ImageObserver, MenuContainer, RootPaneContainer, Serializable

public class JWindow
extends Window
implements Accessible, RootPaneContainer

Unlike JComponent derivatives, JWindow inherits from java.awt.Window. But also lets a look-and-feel component to its work.
See Also:
Serialized Form

Nested Class Summary

protected class
JWindow.AccessibleJWindow
Provides accessibility support for JWindow.

Nested classes/interfaces inherited from class java.awt.Window

Window.AccessibleAWTWindow

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

protected AccessibleContext
accessibleContext
The accessible context associated with this component.
protected JRootPane
rootPane
protected boolean
rootPaneCheckingEnabled

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()
This (package access) constructor is used by subclasses that want to build windows that do not have parents.
JWindow(Frame owner)
Initializes a new instance of Window with the specified parent.
JWindow(GraphicsConfiguration gc)
JWindow(Window owner)
Initializes a new instance of Window with the specified parent.
JWindow(Window owner, GraphicsConfiguration gc)
Initializes a new instance of Window with the specified parent.

Method Summary

protected void
addImpl(Component comp, Object constraints, int index)
This method is called by all the add() methods to perform the actual adding of the component.
protected JRootPane
createRootPane()
AccessibleContext
getAccessibleContext()
If a component supports the Accessibility API then this method should not return null.
Container
getContentPane()
getContentPane
Component
getGlassPane()
getGlassPane
JLayeredPane
getLayeredPane()
getLayeredPane
Dimension
getPreferredSize()
Returns the preferred size of this container.
JRootPane
getRootPane()
getRootPane
protected boolean
isRootPaneCheckingEnabled()
protected String
paramString()
Returns a string representing the state of this container for debugging purposes.
protected void
processKeyEvent(KeyEvent e)
Called when a key event is dispatched and component events are enabled.
void
remove(Component comp)
Removes the specified component from this container.
void
setContentPane(Container contentPane)
setContentPane
void
setGlassPane(Component glassPane)
setGlassPane
void
setLayeredPane(JLayeredPane layeredPane)
setLayeredPane
void
setLayout(LayoutManager manager)
Sets the layout manager for this container to the specified layout manager.
protected void
setRootPane(JRootPane root)
protected void
setRootPaneCheckingEnabled(boolean enabled)
void
update(Graphics g)
Updates this container.
protected void
windowInit()

Methods inherited from class java.awt.Window

addNotify, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getAccessibleContext, getBufferStrategy, getFocusOwner, getFocusableWindowState, getGraphicsConfiguration, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, hide, isActive, isFocusableWindow, isFocused, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setCursor, setFocusableWindowState, setLocationRelativeTo, show, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, setLayout, swapComponents, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFocusable, isFontSet, isForegroundSet, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFocusable, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

accessibleContext

protected AccessibleContext accessibleContext
The accessible context associated with this component. This is only set by subclasses.
Since:
1.2

rootPane

protected JRootPane rootPane

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

Constructor Details

JWindow

public JWindow()
This (package access) constructor is used by subclasses that want to build windows that do not have parents. Eg. toplevel application frames. Subclasses cannot call super(null), since null is an illegal argument.

JWindow

public JWindow(Frame owner)
Initializes a new instance of Window with the specified parent. The window will initially be invisible.
Parameters:
owner - The owning Frame of this window.
Throws:
IllegalArgumentException - If the owner's GraphicsConfiguration is not from a screen device, or if owner is null; this exception is always thrown when GraphicsEnvironment.isHeadless returns true.

JWindow

public JWindow(GraphicsConfiguration gc)

JWindow

public JWindow(Window owner)
Initializes a new instance of Window with the specified parent. The window will initially be invisible.
Throws:
IllegalArgumentException - If the owner's GraphicsConfiguration is not from a screen device, or if owner is null; this exception is always thrown when GraphicsEnvironment.isHeadless returns true.
Since:
1.2

JWindow

public JWindow(Window owner,
               GraphicsConfiguration gc)
Initializes a new instance of Window with the specified parent. The window will initially be invisible.
Throws:
IllegalArgumentException - If owner is null or if gc is not from a screen device; this exception is always thrown when GraphicsEnvironment.isHeadless returns true.
Since:
1.3

Method Details

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)
This method is called by all the add() methods to perform the actual adding of the component. Subclasses who wish to perform their own processing when a component is added should override this method. Any subclass doing this must call the superclass version of this method in order to ensure proper functioning of the container.
Overrides:
addImpl in interface Container
Parameters:
comp - The component to be added.
constraints - The layout constraints for this component, or null if there are no constraints.
index - The index in the component list to insert this child at, or -1 to add at the end of the list.
Throws:
ArrayIndexOutOfBoundsException - If the specified index is invalid.

createRootPane

protected JRootPane createRootPane()

getAccessibleContext

public AccessibleContext getAccessibleContext()
If a component supports the Accessibility API then this method should not return null. Only classes which must extend an accessible class, but must not itself be accessible, may return null.
Specified by:
getAccessibleContext in interface Accessible
Overrides:
getAccessibleContext in interface Window
Returns:
the context associated with this accessible object

getContentPane

public Container getContentPane()
getContentPane
Specified by:
getContentPane in interface RootPaneContainer

getGlassPane

public Component getGlassPane()
getGlassPane
Specified by:
getGlassPane in interface RootPaneContainer

getLayeredPane

public JLayeredPane getLayeredPane()
getLayeredPane
Specified by:
getLayeredPane in interface RootPaneContainer

getPreferredSize

public Dimension getPreferredSize()
Returns the preferred size of this container.
Overrides:
getPreferredSize in interface Container
Returns:
The preferred size of this container.

getRootPane

public JRootPane getRootPane()
getRootPane
Specified by:
getRootPane in interface RootPaneContainer

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

paramString

protected String paramString()
Returns a string representing the state of this container for debugging purposes.
Overrides:
paramString in interface Container
Returns:
A string representing the state of this container.

processKeyEvent

protected void processKeyEvent(KeyEvent e)
Called when a key event is dispatched and component events are enabled. This method passes the event along to any listeners that are attached.
Overrides:
processKeyEvent in interface Component
Parameters:
e - the KeyEvent to process
Throws:
NullPointerException - if e is null
Since:
1.1

remove

public void remove(Component comp)
Removes the specified component from this container.
Overrides:
remove in interface Container
Parameters:
comp - The component to remove from this container.

setContentPane

public void setContentPane(Container contentPane)
setContentPane
Specified by:
setContentPane in interface RootPaneContainer
Parameters:
contentPane - TODO

setGlassPane

public void setGlassPane(Component glassPane)
setGlassPane
Specified by:
setGlassPane in interface RootPaneContainer
Parameters:
glassPane - TODO

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)
setLayeredPane
Specified by:
setLayeredPane in interface RootPaneContainer
Parameters:
layeredPane - TODO

setLayout

public void setLayout(LayoutManager manager)
Sets the layout manager for this container to the specified layout manager.
Overrides:
setLayout in interface Container
Parameters:

setRootPane

protected void setRootPane(JRootPane root)

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

update

public void update(Graphics g)
Updates this container. The implementation of this method in this class forwards to any lightweight components in this container. If this method is subclassed, this method should still be invoked as a superclass method so that lightweight components are properly drawn.
Overrides:
update in interface Container
Parameters:
g - The graphics context for this update.

windowInit

protected void windowInit()

JWindow.java -- Copyright (C) 2002, 2003, 2004, 2005 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.