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应该是contentPane的任何孩子的JWindow 。 作为一种方便， add ， remove和setLayout这个类的方法将被覆盖，所以他们委托给相应方法的调用ContentPane 。 例如，您可以将子组件添加到窗口中，如下所示：

  window.add(child); 

而孩子将被添加到contentPane。 contentPane将永远不是null 。 尝试将其设置为null将导致JWindow引发异常。 默认的contentPane将有一个BorderLayout管理器。 有关添加，删除和设置LayoutManager的LayoutManager的详细信息，请参阅JWindow 。

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

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

警告： Swing不是线程安全的。 有关更多信息，请参阅Swing's Threading Policy 。

警告：此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从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() 获取与此JWindow关联的AccessibleContext。
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的字符串表示 JWindow 。
void	remove(Component comp) 从容器中删除指定的组件。
void	repaint(long time, int x, int y, int width, int height) 在time毫秒内 time绘制该组件的 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

字段详细信息

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

可访问的上下文属性。

构造方法详细信息

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被用于构造与新的窗口; 如果gc为null ，则假定系统默认为GraphicsConfiguration

异常

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

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

从以下版本开始：

1.3

另请参见：

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被用于构造与新的窗口; 如果gc为null ，假设系统默认为GraphicsConfiguration ，除非owner也为空，否则将使用来自共享所有者帧的GraphicsConfiguration 。

异常

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

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

从以下版本开始：

1.3

另请参见：

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 ，则为true; 否则为假

另请参见：

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 。

有关详细信息 ，请参阅Java Tutorial How to Use Drag and Drop and Data Transfer中的一节。

参数

newHandler - 新的 TransferHandler

从以下版本开始：

1.6

另请参见：

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

getTransferHandler

public TransferHandler getTransferHandler()

获取 transferHandler属性。

结果

的价值 transferHandler属性

从以下版本开始：

1.6

另请参见：

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转发，则为true，如果它们应直接在 JWindow上操作，则为false。

另请参见：

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 - 如果向 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

从以下版本开始：

1.6

另请参见：

Component.paint(java.awt.Graphics)

repaint

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

在time毫秒内time绘制该组件的time矩形。 有关如何处理重绘的详细信息，请参阅RepaintManager 。

重写：

repaint在 Component

参数

time - 更新前的最大时间（以毫秒为单位）

x - x坐标

y - y坐标

width - 宽度

height - 高度

从以下版本开始：

1.6

另请参见：

RepaintManager

paramString

protected String paramString()

返回此JWindow的字符串表示JWindow 。 该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。

重写：

paramString在 Container

结果

这个 JWindow的字符串表示 JWindow

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此JWindow关联的AccessibleContext。 对于JWindows，AccessibleContext采用AccessibleJWindow的形式。 如有必要，将创建一个新的AccessibleJWindow实例。

Specified by:

getAccessibleContext在界面 Accessible

重写：

getAccessibleContext在 Window类

结果

一个AccessibleJWindow，用作这个JWindow的AccessibleContext