javax.swing

Class JWindow

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

javax.swing.JWindow

All Implemented Interfaces:

ImageObserver， MenuContainer， Serializable， Accessible， RootPaneContainer

public class JWindow
extends Window
implements Accessible, RootPaneContainer

一个 JWindow是一个容器，可以显示用户的桌面上的任何地方。它没有标题栏，窗口管理按钮，或其他装饰品与 JFrame有关，但它仍然是一个“一等公民”用户的桌面，并可以在任何地方对它的存在。

的JWindow组件包含一个JRootPane作为其唯一的孩子。的contentPane应该是所有孩子的JWindow母。为方便起见，本add，remove，和这类setLayout方法被重写，所以，他们的ContentPane委托调用相应的方法。例如，你可以添加一个组件到一个窗口如下：

窗口。添加（子）；

和孩子将被添加到内容块。的 contentPane永远是非 null。试图把它 null将导致 JWindow抛出一个异常。默认 contentPane将有一个 BorderLayout经理了。参考 RootPaneContainer细节添加，删除和设置一个 JWindow的 LayoutManager。

请看到的contentPane，glassPane完整描述JRootPane文档，和layeredPane组件。

在多屏幕环境中，您可以创建一个不同的屏幕设备JWindow。看到Window更多信息。

警告： Swing是线程不安全的。更多信息见Swing's Threading Policy。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4，为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。

另请参见：

JRootPane

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	JWindow.AccessibleJWindow 这个类实现了对 JWindow类可访问性支持。

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

Window.AccessibleAWTWindow, Window.Type

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
protected AccessibleContext	accessibleContext 可访问的上下文属性。
protected JRootPane	rootPane JRootPane实例的管理 contentPane和可选的 menuBar这个框架，以及 glassPane。
protected boolean	rootPaneCheckingEnabled 如果真的那么叫 add和 setLayout将被转发到 contentPane。

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 and Description
JWindow() 创建没有指定所有者的窗口。
JWindow(Frame owner) 用指定的所有者框架创建一个窗口。
JWindow(GraphicsConfiguration gc) 创建一个具有指定 GraphicsConfiguration屏幕的设备窗口。
JWindow(Window owner) 用指定的所有者窗口创建一个窗口。
JWindow(Window owner, GraphicsConfiguration gc) 创建一个具有指定所有者窗口和 GraphicsConfiguration屏幕的设备窗口。

方法摘要

Modifier and Type	Method and Description
protected void	addImpl(Component comp, Object constraints, int index) 添加指定的孩子 Component。
protected JRootPane	createRootPane() 通过构造函数的方法来创建默认 rootPane。
AccessibleContext	getAccessibleContext() 获取与此相关的accessiblecontext jwindow。
Container	getContentPane() 返回 Container是这个窗口的 contentPane。
Component	getGlassPane() 返回该窗口的 glassPane Component。
Graphics	getGraphics() 为该组件创建一个图形上下文。
JLayeredPane	getLayeredPane() 返回该窗口的 layeredPane对象。
JRootPane	getRootPane() 返回该窗口的 rootPane对象。
TransferHandler	getTransferHandler() 得到 transferHandler财产。
protected boolean	isRootPaneCheckingEnabled() 返回是否调用 add和 setLayout转发给 contentPane。
protected String	paramString() 返回该 JWindow字符串表示形式。
void	remove(Component comp) 从容器中移除指定的组件。
void	repaint(long time, int x, int y, int width, int height) 重画指定矩形的这一部分在 time毫秒。
void	setContentPane(Container contentPane) 设置此窗口的 contentPane财产。
void	setGlassPane(Component glassPane) 集 glassPane财产。
void	setLayeredPane(JLayeredPane layeredPane) 集 layeredPane财产。
void	setLayout(LayoutManager manager) 集 LayoutManager。
protected void	setRootPane(JRootPane root) 设置此窗口的新 rootPane对象。
protected void	setRootPaneCheckingEnabled(boolean enabled) 设置是否 add和 setLayout调用转发给 contentPane。
void	setTransferHandler(TransferHandler newHandler) 集 transferHandler物业，这是一种机制，支持数据为这部分转移。
void	update(Graphics g) 电话 paint(g)。
protected void	windowInit() 通过构造函数来初始化 JWindow正确。

Methods inherited from class java.awt.Window

addNotify, addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBackground, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setOpacity, setShape, setSize, setSize, setType, setVisible, show, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

rootPane

protected JRootPane rootPane

JRootPane实例的管理 contentPane和可选的 menuBar这个框架，以及 glassPane。

另请参见：

getRootPane()， setRootPane(javax.swing.JRootPane)

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

如果真的那么叫 add和 setLayout将被转发到 contentPane。这是最初的错误，而是被设置为true时， JWindow构造。

另请参见：

isRootPaneCheckingEnabled()， setRootPaneCheckingEnabled(boolean)， RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

可访问的上下文属性。

Constructor Detail

JWindow

public JWindow()

创建没有指定所有者的窗口。这个窗口将不可。

此构造函数设置组件的本地化属性返回的值JComponent.getDefaultLocale。

异常

HeadlessException -如果 GraphicsEnvironment.isHeadless()返回true。

另请参见：

GraphicsEnvironment.isHeadless()， Window.isFocusableWindow()， JComponent.getDefaultLocale()

JWindow

public JWindow(GraphicsConfiguration gc)

创建一个具有指定 GraphicsConfiguration屏幕的设备窗口。这个窗口将不可。

此构造函数设置组件的本地化属性返回的值JComponent.getDefaultLocale。

参数

gc - GraphicsConfiguration是用来构建新的窗口；如果是 null GC，系统默认的 GraphicsConfiguration假定

异常

HeadlessException -如果 GraphicsEnvironment.isHeadless()返回true。

IllegalArgumentException -如果 gc不是从一个屏幕的设备。

从以下版本开始：

一点三

另请参见：

GraphicsEnvironment.isHeadless()， Window.isFocusableWindow()， JComponent.getDefaultLocale()

JWindow

public JWindow(Frame owner)

用指定的所有者框架创建一个窗口。如果 owner是 null，共享的所有者将被使用，这个窗口将不可。同时，这个窗口将除非它的主人是在屏幕上显示被聚焦。

此构造函数设置组件的本地化属性返回的值JComponent.getDefaultLocale。

参数

owner -帧从该窗口显示

异常

HeadlessException -如果graphicsenvironment isheadless()返回true。

另请参见：

GraphicsEnvironment.isHeadless()， Window.isFocusableWindow()， JComponent.getDefaultLocale()

JWindow

public JWindow(Window owner)

用指定的所有者窗口创建一个窗口。这个窗口将除非它的主人是在屏幕上显示被聚焦。如果 owner是 null，共享的所有者将被使用，这个窗口将不可。

此构造函数设置组件的本地化属性返回的值JComponent.getDefaultLocale。

参数

owner的窗口，窗口显示

异常

HeadlessException -如果 GraphicsEnvironment.isHeadless()返回true。

另请参见：

GraphicsEnvironment.isHeadless()， Window.isFocusableWindow()， JComponent.getDefaultLocale()

JWindow

public JWindow(Window owner,
               GraphicsConfiguration gc)

创建一个具有指定所有者窗口和 GraphicsConfiguration屏幕的设备窗口。如果 owner是 null，共享的所有者将被使用，这个窗口将不可。

此构造函数设置组件的本地化属性返回的值JComponent.getDefaultLocale。

参数

owner的窗口，窗口显示

gc - GraphicsConfiguration是用来构建新的窗口；如果是 null GC，系统默认的 GraphicsConfiguration假设，除非 owner也是空的，在这种情况下，从共享主框架将使用 GraphicsConfiguration。

异常

HeadlessException -如果 GraphicsEnvironment.isHeadless()返回true。

IllegalArgumentException -如果 gc不是从一个屏幕的设备。

从以下版本开始：

一点三

另请参见：

GraphicsEnvironment.isHeadless()， Window.isFocusableWindow()， JComponent.getDefaultLocale()

方法详细信息

windowInit

protected void windowInit()

通过构造函数来初始化 JWindow正确。

createRootPane

protected JRootPane createRootPane()

通过构造函数的方法来创建默认 rootPane。

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

返回是否调用 add和 setLayout转发给 contentPane。

结果

如果 add和 setLayout转发真；否则为false

另请参见：

addImpl(java.awt.Component, java.lang.Object, int)， setLayout(java.awt.LayoutManager)， setRootPaneCheckingEnabled(boolean)， RootPaneContainer

setTransferHandler

public void setTransferHandler(TransferHandler newHandler)

集 transferHandler物业，这是一种机制，支持数据为这部分转移。如果组件不支持数据传输操作使用 null。

如果系统性能suppressSwingDropSupport是false（默认），这个元件上的电流下降的目标是null或没有用户设置滴目标，这种方法会改变下降的目标如下：如果newHandler是null将明显下降的目标。如果不null将安装一个新的DropTarget。

注意：当使用JWindow，TransferHandler只提供数据导入功能，为数据与出口相关的方法是目前对JComponent型。

请看 How to Use Drag and Drop and Data Transfer，java教程中的一部分，更多的信息。

参数

newHandler -新的 TransferHandler

从以下版本开始：

一点六

另请参见：

TransferHandler， getTransferHandler()， Component.setDropTarget(java.awt.dnd.DropTarget)

getTransferHandler

public TransferHandler getTransferHandler()

得到 transferHandler财产。

结果

该 transferHandler属性的值

从以下版本开始：

一点六

另请参见：

TransferHandler， setTransferHandler(javax.swing.TransferHandler)

update

public void update(Graphics g)

电话 paint(g)。该方法被重写以防止不必要的电话清晰的背景。

重写：

update 方法重写，继承类 Container

参数

g -其中 Graphics背景画

另请参见：

Component.update(Graphics)

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

设置是否 add和 setLayout调用转发给 contentPane。

参数

enabled -如果 add和 setLayout转发，假如果他们应该直接在 JWindow操作。

另请参见：

addImpl(java.awt.Component, java.lang.Object, int)， setLayout(java.awt.LayoutManager)， isRootPaneCheckingEnabled()， RootPaneContainer

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

添加指定的孩子 Component。重写此方法有条件调用转发到 contentPane。默认情况下，孩子们加入代替框架 contentPane，指 RootPaneContainer详情。

重写：

addImpl 方法重写，继承类 Container

参数

comp -可以提高构件的

constraints -被尊重的约束

index -指数

异常

IllegalArgumentException -如果 index无效

IllegalArgumentException如果添加容器的家长本身

IllegalArgumentException如果增加一个窗口一个容器

另请参见：

setRootPaneCheckingEnabled(boolean)， RootPaneContainer

remove

public void remove(Component comp)

从容器中移除指定的组件。如果 comp不是 rootPane，这将给 contentPane。如果这样会 comp不是的 JWindow或 contentPane孩子做什么。

重写：

remove 方法重写，继承类 Container

参数

comp -要移除的组件

异常

NullPointerException -如果 comp是空的

另请参见：

Container.add(java.awt.Component)， RootPaneContainer

setLayout

public void setLayout(LayoutManager manager)

集 LayoutManager。以有条件呼叫转发的 contentPane。指 RootPaneContainer更多信息。

重写：

setLayout 方法重写，继承类 Container

参数

manager - LayoutManager

另请参见：

setRootPaneCheckingEnabled(boolean)， RootPaneContainer

getRootPane

public JRootPane getRootPane()

返回该窗口的 rootPane对象。

Specified by:

getRootPane 接口 RootPaneContainer

结果

此窗口的 rootPane财产

另请参见：

setRootPane(javax.swing.JRootPane)， RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane root)

设置此窗口的新 rootPane对象。此方法被构造函数调用。

参数

root -新的 rootPane财产

另请参见：

getRootPane()

getContentPane

public Container getContentPane()

返回 Container是这个窗口的 contentPane。

Specified by:

getContentPane 接口 RootPaneContainer

结果

的 contentPane财产

另请参见：

setContentPane(java.awt.Container)， RootPaneContainer.getContentPane()

setContentPane

public void setContentPane(Container contentPane)

设置此窗口的 contentPane财产。此方法被构造函数调用。

Specified by:

setContentPane 接口 RootPaneContainer

参数

contentPane -新的 contentPane

异常

IllegalComponentStateException -（运行时异常）如果内容窗格中的参数是 null

另请参见：

getContentPane()， RootPaneContainer.setContentPane(java.awt.Container)

getLayeredPane

public JLayeredPane getLayeredPane()

返回该窗口的 layeredPane对象。

Specified by:

getLayeredPane 接口 RootPaneContainer

结果

的 layeredPane财产

另请参见：

setLayeredPane(javax.swing.JLayeredPane)， RootPaneContainer.getLayeredPane()

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

集 layeredPane财产。此方法被构造函数调用。

Specified by:

setLayeredPane 接口 RootPaneContainer

参数

layeredPane -新的 layeredPane对象

异常

IllegalComponentStateException -（运行时异常）如果内容窗格中的参数是 null

另请参见：

getLayeredPane()， RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()

返回该窗口的 glassPane Component。

Specified by:

getGlassPane 接口 RootPaneContainer

结果

的 glassPane财产

另请参见：

setGlassPane(java.awt.Component)， RootPaneContainer.getGlassPane()

setGlassPane

public void setGlassPane(Component glassPane)

集 glassPane财产。此方法被构造函数调用。

Specified by:

setGlassPane 接口 RootPaneContainer

参数

glassPane -此窗口的 glassPane对象

另请参见：

getGlassPane()， RootPaneContainer.setGlassPane(java.awt.Component)

getGraphics

public Graphics getGraphics()

为该组件创建一个图形上下文。这个方法将返回 null如果该组件是目前不可。

重写：

getGraphics 方法重写，继承类 Component

结果

这一部分图形上下文，或如果它没有 null

从以下版本开始：

一点六

另请参见：

Component.paint(java.awt.Graphics)

repaint

public void repaint(long time,
                    int x,
                    int y,
                    int width,
                    int height)

重画指定矩形的这一部分在 time毫秒。参考 RepaintManager详情如何重新处理。

重写：

repaint 方法重写，继承类 Component

参数

time -毫秒最大时间更新前

x的X坐标

y的Y坐标

width -宽度

height -高度

从以下版本开始：

一点六

另请参见：

RepaintManager

paramString

protected String paramString()

返回该 JWindow字符串表示形式。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。

重写：

paramString 方法重写，继承类 Container

结果

这 JWindow字符串表示形式

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的accessiblecontext jwindow。JWindows的accessiblecontext以一个accessiblejwindow形式。一个新的accessiblejwindow实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 Window

结果

一个accessiblejwindow作为本JWindow的accessiblecontext