- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- java.awt.Window
-
- javax.swing.JWindow
-
- 实现的所有接口
-
ImageObserver,MenuContainer,Serializable,Accessible,RootPaneContainer
@JavaBean(defaultProperty="accessibleContext", description="A toplevel window which has no system border or controls.") public class JWindow extends Window implements Accessible, RootPaneContainer
JWindow是一个可以在用户桌面上的任何位置显示的容器。 它没有标题栏,窗口管理按钮或与JFrame相关的其他装饰,但它仍然是用户桌面的“一等公民”,并且可以存在于其中的任何位置。JWindow组件包含JRootPane作为其唯一的子项。contentPane应该是contentPane的任何子女的JWindow。 为方便起见,addremove和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开始,
java.beans软件包中添加了对所有JavaBeansjava.beans长期存储的支持。 请参阅XMLEncoder。- 从以下版本开始:
- 1.2
- 另请参见:
-
JRootPane, Serialized Form
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected classJWindow.AccessibleJWindow此类实现JWindow类的可访问性支持。-
嵌套类/接口声明在类 java.awt.Window
Window.AccessibleAWTWindow, Window.Type
-
嵌套类/接口声明在类 java.awt.Container
Container.AccessibleAWTContainer
-
-
字段汇总
字段 变量和类型 字段 描述 protected AccessibleContextaccessibleContext可访问的上下文属性。protected JRootPanerootPane管理contentPane的JRootPane实例和此框架的可选menuBar,以及glassPane。protected booleanrootPaneCheckingEnabled如果为true,则致电add和setLayout将转发至contentPane。-
声明的属性在类 java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields declared in interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
-
构造方法摘要
构造方法 构造器 描述 JWindow()创建一个没有指定所有者的窗口。JWindow(Frame owner)创建具有指定所有者框架的窗口。JWindow(GraphicsConfiguration gc)使用指定的GraphicsConfiguration屏幕设备创建一个窗口。JWindow(Window owner)使用指定的所有者窗口创建一个窗口。JWindow(Window owner, GraphicsConfiguration gc)使用指定的所有者窗口和屏幕设备的GraphicsConfiguration创建一个窗口。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 protected voidaddImpl(Component comp, Object constraints, int index)添加指定的子项Component。protected JRootPanecreateRootPane()由构造函数方法调用以创建默认值rootPane。AccessibleContextgetAccessibleContext()获取与此JWindow关联的AccessibleContext。ContainergetContentPane()返回Container,这是该窗口的contentPane。ComponentgetGlassPane()返回此窗口的glassPane Component。GraphicsgetGraphics()为此组件创建图形上下文。JLayeredPanegetLayeredPane()返回此窗口的layeredPane对象。JRootPanegetRootPane()返回此窗口的rootPane对象。TransferHandlergetTransferHandler()获取transferHandler属性。protected booleanisRootPaneCheckingEnabled()返回对add和setLayout调用是否转发到contentPane。protected StringparamString()返回此JWindow的字符串表示JWindow。voidremove(Component comp)从容器中删除指定的组件。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属性,这是一种支持将数据传输到此组件的机制。voidupdate(Graphics g)致电paint(g)。protected voidwindowInit()由构造函数调用以正确初始化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
protected JRootPane rootPane
管理contentPane的JRootPane实例和此框架的可选menuBar,以及glassPane。
-
rootPaneCheckingEnabled
protected boolean rootPaneCheckingEnabled
如果为true,则对add和setLayout调用将转发到contentPane。 这最初为false,但在构造JWindow时设置为true。
-
accessibleContext
protected AccessibleContext accessibleContext
可访问的上下文属性。
-
-
构造方法详细信息
-
JWindow
public JWindow()
创建一个没有指定所有者的窗口。 此窗口不可调焦。此构造函数将组件的locale属性设置为
JComponent.getDefaultLocale返回的值。- 异常
-
HeadlessException- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless(),Window.isFocusableWindow(),JComponent.getDefaultLocale()
-
JWindow
public JWindow(GraphicsConfiguration gc)
创建一个具有指定的屏幕设备GraphicsConfiguration的窗口。 此窗口不可调焦。此构造函数将组件的locale属性设置为
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,将使用共享所有者,并且此窗口将不可聚焦。 此外,除非所有者在屏幕上显示,否则此窗口将无法聚焦。此构造函数将组件的locale属性设置为
JComponent.getDefaultLocale返回的值。- 参数
-
owner- 显示窗口的框架 - 异常
-
HeadlessException- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless(),Window.isFocusableWindow(),JComponent.getDefaultLocale()
-
JWindow
public JWindow(Window owner)
使用指定的所有者窗口创建一个窗口。 除非其所有者在屏幕上显示,否则此窗口将无法聚焦。 如果owner是null,将使用共享所有者,并且此窗口将不可聚焦。此构造函数将组件的locale属性设置为
JComponent.getDefaultLocale返回的值。- 参数
-
owner- 显示窗口的窗口 - 异常
-
HeadlessException- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless(),Window.isFocusableWindow(),JComponent.getDefaultLocale()
-
JWindow
public JWindow(Window owner, GraphicsConfiguration gc)
使用指定的所有者窗口和屏幕设备的GraphicsConfiguration创建一个窗口。 如果owner是null,将使用共享所有者,并且此窗口将不可聚焦。此构造函数将组件的locale属性设置为
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。- 结果
-
一个新的
JRootPane
-
isRootPaneCheckingEnabled
protected boolean isRootPaneCheckingEnabled()
返回对add和setLayout调用是否转发到contentPane。- 结果
-
如果
add和setLayout被转发,setLayouttrue; 否则是假的 - 另请参见:
-
addImpl(java.awt.Component, java.lang.Object, int),setLayout(java.awt.LayoutManager),setRootPaneCheckingEnabled(boolean),RootPaneContainer
-
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。注意:当与
JWindowTransferHandler使用时,TransferHandler仅提供数据导入功能,因为数据导出相关方法当前键入JComponent。有关详细信息,请参阅“Java教程”中的 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
@BeanProperty(hidden=true, description="Whether the add and setLayout methods are forwarded") protected void setRootPaneCheckingEnabled(boolean enabled)
设置是否add和setLayout呼叫转发到contentPane。- 参数
-
enabled- 如果转发add和setLayouttrue,如果它们应直接在JWindow上运行,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的子级,则contentPane。- 重写:
-
remove类Container - 参数
-
comp- 要删除的组件 - 异常
-
NullPointerException- 如果comp为空 - 另请参见:
-
Container.add(java.awt.Component),RootPaneContainer
-
setLayout
public void setLayout(LayoutManager manager)
- 重写:
-
setLayout类Container - 参数
-
manager-LayoutManager - 另请参见:
-
setRootPaneCheckingEnabled(boolean),RootPaneContainer
-
getRootPane
@BeanProperty(bound=false, hidden=true, description="the RootPane object for this window.") 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
@BeanProperty(bound=false, hidden=true, description="The client area of the window where child components are normally inserted.") 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
@BeanProperty(bound=false, hidden=true, description="The pane which holds the various window layers.") 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
@BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)
设置glassPane属性。 构造函数调用此方法。- Specified by:
-
setGlassPane在接口RootPaneContainer - 参数
-
glassPane- 此窗口的glassPane对象 - 另请参见:
-
getGlassPane(),RootPaneContainer.setGlassPane(java.awt.Component)
-
getGraphics
@BeanProperty(bound=false) 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毫秒内重新绘制此组件的指定矩形。 有关如何处理重绘的详细信息,请参阅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 - 结果
- an AccessibleJWindow that serves as the AccessibleContext of this JWindow
-
-