- 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 JWindowextends Windowimplements 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开始,
java.beans
软件包中添加了对所有JavaBeansjava.beans
长期存储的支持。 请参阅XMLEncoder
。- 从以下版本开始:
- 1.2
- 另请参见:
-
JRootPane
, Serialized Form
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected class
JWindow.AccessibleJWindow
此类实现JWindow
类的可访问性支持。-
嵌套类/接口声明在类 java.awt.Window
Window.AccessibleAWTWindow, Window.Type
-
嵌套类/接口声明在类 java.awt.Container
Container.AccessibleAWTContainer
-
-
字段汇总
字段 变量和类型 字段 描述 protected AccessibleContext
accessibleContext
可访问的上下文属性。protected JRootPane
rootPane
管理contentPane
的JRootPane
实例和此框架的可选menuBar
,以及glassPane
。protected boolean
rootPaneCheckingEnabled
如果为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 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
毫秒内重新绘制此组件的指定矩形。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
。-
声明方法的类 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
被转发,setLayout
true; 否则是假的 - 另请参见:
-
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
。注意:当与
JWindow
TransferHandler
使用时,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
和setLayout
true,如果它们应直接在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
-
-