- 所有已实现的接口:
ImageObserver,MenuContainer,Serializable,Accessible,RootPaneContainer
JWindow 是一个容器,可以显示在用户桌面的任何位置。它没有标题栏、窗口管理按钮或其他与 JFrame 相关的装饰,但它仍然是用户桌面的“一等公民”,可以存在于桌面的任何位置。
JWindow 组件包含一个 JRootPane 作为其唯一的子组件。 contentPane 应该是 JWindow 的任何子级的父级。为方便起见,覆盖了此类的 add、remove 和 setLayout 方法,以便它们将调用委托给 ContentPane 的相应方法。例如,您可以将子组件添加到窗口,如下所示:
window.add(child);并且孩子将被添加到 contentPane。
contentPane 将始终是非 null 。尝试将其设置为 null 将导致 JWindow 引发异常。默认的 contentPane 将设置一个 BorderLayout 管理器。有关添加、删除和设置 JWindow 的 LayoutManager 的详细信息,请参阅 RootPaneContainer 。
有关 contentPane、glassPane 和 layeredPane 组件的完整说明,请参阅 JRootPane 文档。
在多屏环境中,您可以在不同的屏幕设备上创建JWindow。有关详细信息,请参阅 Window 。
Warning: Swing 不是线程安全的。有关详细信息,请参阅 Swing 的线程策略。
Warning: 此类的序列化对象将与未来的 Swing 版本不兼容。当前的序列化支持适用于运行相同版本 Swing 的应用程序之间的短期存储或 RMI。从 1.4 开始,对所有 JavaBeans 的长期存储的支持已添加到 java.beans 包中。请参阅 XMLEncoder 。
- 自从:
- 1.2
- 参见:
-
内部类总结
内部类在类 java.awt.Window 中声明的嵌套类/接口
Window.AccessibleAWTWindow, Window.Type在类 java.awt.Container 中声明的嵌套类/接口
Container.AccessibleAWTContainer -
字段摘要
字段修饰符和类型Field描述protected AccessibleContext可访问的上下文属性。protected JRootPane管理该帧的contentPane和可选的menuBar以及glassPane的JRootPane实例。protected boolean如果为真,则对add和setLayout的调用将被转发到contentPane。在类 java.awt.Component 中声明的字段
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT在接口 java.awt.image.ImageObserver 中声明的字段
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH -
构造方法总结
构造方法构造方法描述JWindow()创建一个没有指定所有者的窗口。创建具有指定所有者框架的窗口。使用屏幕设备的指定GraphicsConfiguration创建一个窗口。创建具有指定所有者窗口的窗口。JWindow(Window owner, GraphicsConfiguration gc) 使用指定的所有者窗口和屏幕设备的GraphicsConfiguration创建一个窗口。 -
方法总结
修饰符和类型方法描述protected void添加指定的孩子Component。protected JRootPane由构造方法调用以创建默认的rootPane。获取与此 JWindow 关联的 AccessibleContext。返回Container,即此窗口的contentPane。返回此窗口的glassPane Component。为此组件创建图形上下文。返回此窗口的layeredPane对象。返回此窗口的rootPane对象。获取transferHandler属性。protected boolean返回对add和setLayout的调用是否转发到contentPane。protected String返回此JWindow的字符串表示形式void从容器中移除指定的组件。voidrepaint(long time, int x, int y, int width, int height) 在time毫秒内重新绘制此组件的指定矩形。voidsetContentPane(Container contentPane) 为此窗口设置contentPane属性。voidsetGlassPane(Component glassPane) 设置glassPane属性。voidsetLayeredPane(JLayeredPane layeredPane) 设置layeredPane属性。voidsetLayout(LayoutManager manager) 设置LayoutManager。protected voidsetRootPane(JRootPane root) 为此窗口设置新的rootPane对象。protected voidsetRootPaneCheckingEnabled(boolean enabled) 设置是否将对add和setLayout的调用转发到contentPane。voidsetTransferHandler(TransferHandler newHandler) 设置transferHandler属性,这是一种支持将数据传输到此组件的机制。void呼叫paint(g)。protected void由构造函数调用以正确初始化JWindow。在类 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, 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在类 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, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree在类 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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
字段详细信息
-
rootPane
管理该帧的contentPane和可选的menuBar以及glassPane的JRootPane实例。- 参见:
-
rootPaneCheckingEnabled
protected boolean rootPaneCheckingEnabled如果为真,则对add和setLayout的调用将被转发到contentPane。这最初是 false,但在构造JWindow时设置为 true。- 参见:
-
accessibleContext
可访问的上下文属性。
-
-
构造方法详细信息
-
JWindow
public JWindow()创建一个没有指定所有者的窗口。该窗口将不可聚焦。此构造函数将组件的locale属性设置为
JComponent.getDefaultLocale返回的值。- 抛出:
HeadlessException- 如果GraphicsEnvironment.isHeadless()返回真。- 参见:
-
JWindow
使用屏幕设备的指定GraphicsConfiguration创建一个窗口。该窗口将不可聚焦。此构造函数将组件的locale属性设置为
JComponent.getDefaultLocale返回的值。- 参数:
gc- 用于构建新窗口的GraphicsConfiguration;如果 gc 是null,则假定系统默认值GraphicsConfiguration- 抛出:
HeadlessException- 如果GraphicsEnvironment.isHeadless()返回真。IllegalArgumentException- 如果gc不是来自屏幕设备。- 自从:
- 1.3
- 参见:
-
JWindow
创建具有指定所有者框架的窗口。如果owner是null,则将使用共享所有者并且此窗口将不可聚焦。此外,除非其所有者显示在屏幕上,否则此窗口将无法获得焦点。此构造函数将组件的locale属性设置为
JComponent.getDefaultLocale返回的值。- 参数:
owner- 显示窗口的框架- 抛出:
HeadlessException- 如果 GraphicsEnvironment.isHeadless() 返回 true。- 参见:
-
JWindow
创建具有指定所有者窗口的窗口。除非其所有者显示在屏幕上,否则此窗口将不可聚焦。如果owner是null,则将使用共享所有者并且此窗口将不可聚焦。此构造函数将组件的locale属性设置为
JComponent.getDefaultLocale返回的值。- 参数:
owner- 显示窗口的窗口- 抛出:
HeadlessException- 如果GraphicsEnvironment.isHeadless()返回真。- 参见:
-
JWindow
使用指定的所有者窗口和屏幕设备的GraphicsConfiguration创建一个窗口。如果owner是null,则将使用共享所有者并且此窗口将不可聚焦。此构造函数将组件的locale属性设置为
JComponent.getDefaultLocale返回的值。- 参数:
owner- 显示窗口的窗口gc- 用于构建新窗口的GraphicsConfiguration;如果 gc 是null,则假定系统默认值GraphicsConfiguration,除非owner也为空,在这种情况下,将使用来自共享所有者框架的GraphicsConfiguration。- 抛出:
HeadlessException- 如果GraphicsEnvironment.isHeadless()返回真。IllegalArgumentException- 如果gc不是来自屏幕设备。- 自从:
- 1.3
- 参见:
-
-
方法详情
-
windowInit
protected void windowInit()由构造函数调用以正确初始化JWindow。 -
createRootPane
由构造方法调用以创建默认的rootPane。- 返回:
-
一个新的
JRootPane
-
isRootPaneCheckingEnabled
protected boolean isRootPaneCheckingEnabled()返回对add和setLayout的调用是否转发到contentPane。- 返回:
-
如果
add和setLayout被转发则为真;否则为假 - 参见:
-
setTransferHandler
@BeanProperty (hidden =true, description ="Mechanism for transfer of data into the component") public void setTransferHandler(TransferHandler newHandler) 设置transferHandler属性,这是一种支持将数据传输到此组件的机制。如果组件不支持数据传输操作,请使用null。如果系统属性
suppressSwingDropSupport是false(默认值)并且此组件上的当前放置目标是null或不是用户设置的放置目标,则此方法将按如下方式更改放置目标:如果newHandler是null它将清除放置目标。如果不是null,它将安装一个新的DropTarget。注意:当与
JWindow一起使用时,TransferHandler仅提供数据导入功能,因为数据导出相关方法当前类型为JComponent。请参阅 如何使用拖放和数据传输,The Java Tutorial 中的一个部分,了解更多信息。
- 参数:
newHandler- 新的TransferHandler- 自从:
- 1.6
- 参见:
-
getTransferHandler
获取transferHandler属性。- 返回:
transferHandler属性的值- 自从:
- 1.6
- 参见:
-
update
呼叫paint(g)。重写此方法以防止不必要的调用来清除背景。 -
setRootPaneCheckingEnabled
@BeanProperty (hidden =true, description ="Whether the add and setLayout methods are forwarded") protected void setRootPaneCheckingEnabled(boolean enabled) 设置是否将对add和setLayout的调用转发到contentPane。- 参数:
enabled- 如果转发add和setLayout则为真,如果它们应直接在JWindow上操作则为假。- 参见:
-
addImpl
添加指定的孩子Component。此方法被覆盖以有条件地将调用转发给contentPane。默认情况下,孩子被添加到contentPane而不是框架,有关详细信息,请参阅RootPaneContainer。- 重写:
addImpl在类Container中- 参数:
comp- 要增强的组件constraints- 要遵守的约束index- 索引- 抛出:
IllegalArgumentException- 如果index无效IllegalArgumentException- 如果将容器的父级添加到自身IllegalArgumentException- 如果向容器添加窗口- 参见:
-
remove
从容器中移除指定的组件。如果comp不是rootPane,这会将调用转发给contentPane。如果comp不是JWindow或contentPane的子级,这将不执行任何操作。- 重写:
remove在类Container中- 参数:
comp- 要删除的组件- 抛出:
NullPointerException- 如果comp为空- 参见:
-
setLayout
-
getRootPane
@BeanProperty (bound =false, hidden =true, description ="the RootPane object for this window.") public JRootPane getRootPane()返回此窗口的rootPane对象。- 指定者:
getRootPane在接口RootPaneContainer中- 返回:
-
此窗口的
rootPane属性 - 参见:
-
setRootPane
为此窗口设置新的rootPane对象。该方法由构造函数调用。- 参数:
root- 新的rootPane属性- 参见:
-
getContentPane
返回Container,即此窗口的contentPane。- 指定者:
getContentPane在接口RootPaneContainer中- 返回:
contentPane属性- 参见:
-
setContentPane
@BeanProperty (bound =false, hidden =true, description ="The client area of the window where child components are normally inserted.") public void setContentPane(Container contentPane) 为此窗口设置contentPane属性。该方法由构造函数调用。- 指定者:
setContentPane在接口RootPaneContainer中- 参数:
contentPane- 新的contentPane- 抛出:
IllegalComponentStateException-(运行时异常)如果内容窗格参数为null- 参见:
-
getLayeredPane
返回此窗口的layeredPane对象。- 指定者:
getLayeredPane在接口RootPaneContainer中- 返回:
layeredPane属性- 参见:
-
setLayeredPane
@BeanProperty (bound =false, hidden =true, description ="The pane which holds the various window layers.") public void setLayeredPane(JLayeredPane layeredPane) 设置layeredPane属性。该方法由构造函数调用。- 指定者:
setLayeredPane在接口RootPaneContainer中- 参数:
layeredPane- 新的layeredPane对象- 抛出:
IllegalComponentStateException-(运行时异常)如果内容窗格参数为null- 参见:
-
getGlassPane
返回此窗口的glassPane Component。- 指定者:
getGlassPane在接口RootPaneContainer中- 返回:
glassPane属性- 参见:
-
setGlassPane
@BeanProperty (bound =false, hidden =true, description ="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane) 设置glassPane属性。该方法由构造函数调用。- 指定者:
setGlassPane在接口RootPaneContainer中- 参数:
glassPane- 此窗口的glassPane对象- 参见:
-
getGraphics
为此组件创建图形上下文。如果此组件当前不可显示,此方法将返回null。- 重写:
getGraphics在类Component中- 返回:
-
此组件的图形上下文,如果没有则为
null - 自从:
- 1.6
- 参见:
-
repaint
public void repaint(long time, int x, int y, int width, int height) 在time毫秒内重新绘制此组件的指定矩形。有关如何处理重绘的详细信息,请参阅RepaintManager。 -
paramString
返回此JWindow的字符串表示形式。此方法仅用于调试目的,返回字符串的内容和格式可能因实现而异。返回的字符串可能为空,但可能不是null。- 重写:
paramString在类Container中- 返回:
-
这个
JWindow的字符串表示
-
getAccessibleContext
获取与此 JWindow 关联的 AccessibleContext。对于 JWindows,AccessibleContext 采用 AccessibleJWindow 的形式。如有必要,将创建一个新的 AccessibleJWindow 实例。- 指定者:
getAccessibleContext在接口Accessible中- 重写:
getAccessibleContext在类Window中- 返回:
- 作为此 JWindow 的 AccessibleContext 的 AccessibleJWindow
-