JFrame

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.swing
类 JFrame

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Frame
                  javax.swing.JFrame

所有已实现的接口：: ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public class JFrame
extends Frame
implements WindowConstants, Accessible, RootPaneContainer

java.awt.Frame 的扩展版本，该版本添加了对 JFC/Swing 组件架构的支持。有关使用 JFrame 的面向任务的文档，请参阅 The Java Tutorial 中的 How to Make Frames 一节。

JFrame 类与 Frame 轻微不兼容。与其他所有 JFC/Swing 顶层容器一样，JFrame 包含一个 JRootPane 作为其唯一的子容器。根据规定，根窗格所提供的内容窗格应该包含 JFrame 所显示的所有非菜单组件。这不同于 AWT Frame。为了方便地使用 add 及其变体，已经重写了 remove 和 setLayout，以在必要时将其转发到 contentPane。这意味着可以编写：

       frame.add(child);

子级将被添加到 contentPane。内容窗格始终是非 null 的。试图将其设置为 null 会导致 JFrame 抛出异常。默认的内容窗格上会设置有 BorderLayout 管理器。有关添加、移除和设置 JFrame 的 LayoutManager 的详细信息，请参阅 RootPaneContainer。

与 Frame 不同，当用户试图关闭窗口时，JFrame 知道如何进行响应。用户关闭窗口时，默认的行为只是简单地隐藏 JFrame。要更改默认的行为，可调用方法 setDefaultCloseOperation(int)。要使 JFrame 的行为与 Frame 实例相同，请使用 setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE)。

有关内容窗格和根窗格提供的其他功能的更多信息，请参阅 The Java Tutorial 中的 Using Top-Level Containers 一节。

在多屏幕环境中，可以在不同的屏幕设备上创建一个 JFrame。有关更多信息，请参阅 Frame。

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

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参阅 XMLEncoder。

另请参见：: JRootPane, setDefaultCloseOperation(int), WindowListener.windowClosing(java.awt.event.WindowEvent), RootPaneContainer

嵌套类摘要
`protected class`	`JFrame.AccessibleJFrame` 此类实现对 `JFrame` 类的可访问性支持。

从类 java.awt.Frame 继承的嵌套类/接口
`Frame.AccessibleAWTFrame`

从类 java.awt.Window 继承的嵌套类/接口
`Window.AccessibleAWTWindow`

从类 java.awt.Container 继承的嵌套类/接口
`Container.AccessibleAWTContainer`

从类 java.awt.Component 继承的嵌套类/接口
`Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy`

字段摘要
`protected AccessibleContext`	`accessibleContext` 可访问的上下文属性。
`static int`	`EXIT_ON_CLOSE` 退出应用程序后的默认窗口关闭操作。
`protected JRootPane`	`rootPane` `JRootPane` 实例管理此窗体的 `contentPane` 和可选的 `menuBar`，以及 `glassPane`。
`protected boolean`	`rootPaneCheckingEnabled` 如果为 true，则将对 `add` 和 `setLayout` 的调用转发到 `contentPane`。

从类 java.awt.Frame 继承的字段
`CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR`

从类 java.awt.Component 继承的字段
`BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT`

从接口 javax.swing.WindowConstants 继承的字段
`DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE`

从接口 java.awt.image.ImageObserver 继承的字段
`ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH`

构造方法摘要
`JFrame()` 构造一个初始时不可见的新窗体。
`JFrame(GraphicsConfiguration gc)` 以屏幕设备的指定 `GraphicsConfiguration` 和空白标题创建一个 `Frame`。
`JFrame(String title)` 创建一个新的、初始不可见的、具有指定标题的 `Frame`。
`JFrame(String title, GraphicsConfiguration gc)` 创建一个具有指定标题和指定屏幕设备的 `GraphicsConfiguration` 的 `JFrame`。

方法摘要
`protected void`	`addImpl(Component comp, Object constraints, int index)` 添加指定的子 `Component`。
`protected JRootPane`	`createRootPane()` 由构造方法调用，以创建默认的 `rootPane`。
`protected void`	`frameInit()` 由构造方法调用，以适当地初始化 `JFrame`。
`AccessibleContext`	`getAccessibleContext()` 获得与此 JFrame 关联的 AccessibleContext。
`Container`	`getContentPane()` 返回此窗体的 `contentPane` 对象
`int`	`getDefaultCloseOperation()` 返回用户在此窗体上发起 "close" 时执行的操作。
`Component`	`getGlassPane()` 返回此窗体的 `glassPane` 对象。
`Graphics`	`getGraphics()` 为组件创建一个图形上下文。
`JMenuBar`	`getJMenuBar()` 返回此窗体上设置的菜单栏。
`JLayeredPane`	`getLayeredPane()` 返回此窗体的 `layeredPane` 对象。
`JRootPane`	`getRootPane()` 返回此窗体的 `rootPane` 对象。
`TransferHandler`	`getTransferHandler()` 获取 `transferHandler` 属性。
`static boolean`	`isDefaultLookAndFeelDecorated()` 如果新创建的 `JFrame` 应该由当前外观为其提供 Window 装饰，则返回 true。
`protected boolean`	`isRootPaneCheckingEnabled()` 返回是否将对 `add` 和 `setLayout` 的调用转发到 `contentPane`。
`protected String`	`paramString()` 返回此 `JFrame` 的字符串表示形式。
`protected void`	`processWindowEvent(WindowEvent e)` 处理此组件上发生的窗口事件。
`void`	`remove(Component comp)` 从该容器中移除指定组件。
`void`	`repaint(long time, int x, int y, int width, int height)` 在 `time` 毫秒内重绘此组件的指定矩形区域。
`void`	`setContentPane(Container contentPane)` 设置 `contentPane` 属性。
`void`	`setDefaultCloseOperation(int operation)` 设置用户在此窗体上发起 "close" 时默认执行的操作。
`static void`	`setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)` 提供一个关于新创建的 `JFrame` 是否应该具有当前外观为其提供的 Window 装饰（如边框、关闭窗口的小部件、标题等等）的提示。
`void`	`setGlassPane(Component glassPane)` 设置 `glassPane` 属性。
`void`	`setIconImage(Image image)` 设置要作为此窗口图标显示的图像。
`void`	`setJMenuBar(JMenuBar menubar)` 设置此窗体的菜单栏。
`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)`。

从类 java.awt.Frame 继承的方法
`addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setResizable, setState, setTitle, setUndecorated`

从类 java.awt.Window 继承的方法
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setVisible, show, toBack, toFront

从类 java.awt.Window 继承的方法

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, 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, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, transferFocusDownCycle, validate, validateTree

从类 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, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, 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, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, 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, isOpaque, 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, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle

从类 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, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, 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, isOpaque, 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, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

从接口 java.awt.MenuContainer 继承的方法
`getFont, postEvent`

字段详细信息

EXIT_ON_CLOSE

public static final int EXIT_ON_CLOSE

退出应用程序后的默认窗口关闭操作。如果执行关闭操作时窗口具有此设置，并且是在 applet 中关闭窗口，则可能抛出 SecurityException。建议仅在应用程序中使用此设置。

从以下版本开始：: 1.3
另请参见：: 常量字段值

rootPane

protected JRootPane rootPane

JRootPane 实例管理此窗体的 contentPane 和可选的 menuBar，以及 glassPane。

另请参见：: JRootPane, RootPaneContainer

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

如果为 true，则将对 add 和 setLayout 的调用转发到 contentPane。此设置初始为 false，但在构建 JFrame 时将其设置为 true。

另请参见：: isRootPaneCheckingEnabled(), setRootPaneCheckingEnabled(boolean), RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

可访问的上下文属性。

构造方法详细信息

public JFrame()
       throws HeadlessException

构造一个初始时不可见的新窗体。

此构造方法将组件的 locale 属性设置为 JComponent.getDefaultLocale 所返回的值。

抛出：: HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。
另请参见：: GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean), JComponent.getDefaultLocale()

JFrame

public JFrame(GraphicsConfiguration gc)

以屏幕设备的指定 GraphicsConfiguration 和空白标题创建一个 Frame。

此构造方法将组件的 locale 属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：: gc - 用于构造新 Frame 的 GraphicsConfiguration；如果 gc 为 null，则使用系统默认的 GraphicsConfiguration
抛出：: IllegalArgumentException - 如果 gc 不是来自屏幕设备。GraphicsEnvironment.isHeadless() 返回 true 时总是抛出此异常。
从以下版本开始：: 1.3
另请参见：: GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

JFrame

public JFrame(String title)
       throws HeadlessException

创建一个新的、初始不可见的、具有指定标题的 Frame。

此构造方法将组件的 locale 属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：: title - 该窗体的标题
抛出：: HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。
另请参见：: GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean), JComponent.getDefaultLocale()

JFrame

public JFrame(String title,
              GraphicsConfiguration gc)

创建一个具有指定标题和指定屏幕设备的 GraphicsConfiguration 的 JFrame。

此构造方法将组件的 locale 属性设置为 JComponent.getDefaultLocale 所返回的值。

参数：: title - 要显示在窗体边框中的标题。将 null 值视为空字符串 ""。; gc - 用于构造新 JFrame 的 GraphicsConfiguration；如果 gc 为 null，则使用系统默认的 GraphicsConfiguration

抛出：

IllegalArgumentException - 如果 gc 不是来自屏幕设备。GraphicsEnvironment.isHeadless() 返回 true 时总是抛出此异常。

从以下版本开始：

1.3

另请参见：

GraphicsEnvironment.isHeadless(), JComponent.getDefaultLocale()

方法详细信息

frameInit

protected void frameInit()

由构造方法调用，以适当地初始化 JFrame。

createRootPane

protected JRootPane createRootPane()

由构造方法调用，以创建默认的 rootPane。

processWindowEvent

protected void processWindowEvent(WindowEvent e)

处理此组件上发生的窗口事件。隐藏窗口或释放窗口，根据 defaultCloseOperation 属性的设置来指定。

覆盖：: 类 Window 中的 processWindowEvent

参数：: e - 窗口事件
另请参见：: setDefaultCloseOperation(int), Window.processWindowEvent(java.awt.event.WindowEvent)

setDefaultCloseOperation

public void setDefaultCloseOperation(int operation)

设置用户在此窗体上发起 "close" 时默认执行的操作。必须指定以下选项之一：

DO_NOTHING_ON_CLOSE（在 WindowConstants 中定义）：不执行任何操作；要求程序在已注册的 WindowListener 对象的 windowClosing 方法中处理该操作。
HIDE_ON_CLOSE（在 WindowConstants 中定义）：调用任意已注册的 WindowListener 对象后自动隐藏该窗体。
DISPOSE_ON_CLOSE（在 WindowConstants 中定义）：调用任意已注册 WindowListener 的对象后自动隐藏并释放该窗体。
EXIT_ON_CLOSE（在 JFrame 中定义）：使用 System exit 方法退出应用程序。仅在应用程序中使用。

默认情况下，该值被设置为 HIDE_ON_CLOSE。更改此属性的值将导致激发属性更改事件，其属性名称为 "defaultCloseOperation"。

注：当 Java 虚拟机 (VM) 中最后一个可显示窗口被释放后，虚拟机可能会终止。有关更多信息，请参阅 AWT Threading Issues。

参数：: operation - 用户关闭该窗体时应该执行的操作
抛出：: IllegalArgumentException - 如果 defaultCloseOperation 值不是上述有效值之一; SecurityException - 如果已指定 EXIT_ON_CLOSE 并且 SecurityManager 不允许调用者调用 System.exit

另请参见：

Window.addWindowListener(java.awt.event.WindowListener), getDefaultCloseOperation(), WindowConstants, Runtime.exit(int)

getDefaultCloseOperation

public int getDefaultCloseOperation()

返回用户在此窗体上发起 "close" 时执行的操作。

返回：: 一个指示窗口关闭操作的整数
另请参见：: setDefaultCloseOperation(int)

setTransferHandler

public void setTransferHandler(TransferHandler newHandler)

设置 transferHandler 属性，该属性是支持向此组件传输数据的机制。如果该组件不支持数据传输操作，那么请使用 null。

如果系统属性 suppressSwingDropSupport 为 false（默认值），并且此组件上的当前放置目标为 null 或者不是用户设置的放置目标，则此方法将按如下方式更改放置目标：如果 newHandler 为 null，则它将清除放置目标。如果不为 null，则它将安装一个新的 DropTarget。

注：当用于 JFrame 时，TransferHandler 只提供数据导入功能，与数据导出相关的方法当前用于 JComponent。

有关更多信息，请参阅 The 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)。重写此方法，以防止不必要的调用清除背景。

覆盖：: 类 Container 中的 update

参数：: g - 要在其中进行绘制的 Graphics 上下文
另请参见：: Component.update(Graphics)

setJMenuBar

public void setJMenuBar(JMenuBar menubar)

设置此窗体的菜单栏。

参数：: menubar - 放置于该窗体中的菜单栏
另请参见：: getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

返回此窗体上设置的菜单栏。

返回：: 此窗体的菜单栏
另请参见：: setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

返回是否将对 add 和 setLayout 的调用转发到 contentPane。

返回：: 如果转发 add 和 setLayout，则返回 true；否则返回 false
另请参见：: addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), setRootPaneCheckingEnabled(boolean), RootPaneContainer

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

设置是否将对 add 和 setLayout 的调用转发到 contentPane。

参数：: enabled - 如果转发 add 和 setLayout，则为 true；如果应直接在 JFrame 上操作，则为 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。

覆盖：: 类 Container 中的 addImpl

参数：: comp - 要添加子组件的组件; constraints - 要遵守的约束条件; index - 索引

抛出：

IllegalArgumentException - 如果 index 无效

IllegalArgumentException - 如果将容器的父级添加到其本身

IllegalArgumentException - 如果向容器内添加窗口

另请参见：

setRootPaneCheckingEnabled(boolean), RootPaneContainer

remove

public void remove(Component comp)

从该容器中移除指定组件。如果 comp 不是 rootPane，则将调用转发到 contentPane。如果 comp 不是 JFrame 或 contentPane 的子级，则不执行任何操作。

覆盖：: 类 Container 中的 remove

参数：: comp - 要移除的组件
抛出：: NullPointerException - 如果 comp 为 null
另请参见：: Container.add(java.awt.Component), RootPaneContainer

setLayout

public void setLayout(LayoutManager manager)

设置 LayoutManager。重写此方法，从而有条件地将调用转发到 contentPane。有关更多信息，请参阅 RootPaneContainer。

覆盖：: 类 Container 中的 setLayout

参数：: manager - LayoutManager
另请参见：: setRootPaneCheckingEnabled(boolean), RootPaneContainer

getRootPane

public JRootPane getRootPane()

返回此窗体的 rootPane 对象。

指定者：: 接口 RootPaneContainer 中的 getRootPane

返回：: rootPane 属性
另请参见：: setRootPane(javax.swing.JRootPane), RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane root)

设置 rootPane 属性。此方法由构造方法调用。

参数：: root - 此窗体的 rootPane 对象
另请参见：: getRootPane()

setIconImage

public void setIconImage(Image image)

设置要作为此窗口图标显示的图像。

将单个图像指定为窗口的图标时，可以使用此方法代替 setIconImages()。

以下语句：

     setIconImage(image);

等价于：

     ArrayList imageList = new ArrayList();
     imageList.add(image);
     setIconImages(imageList);

注：根据上下文的不同（例如，窗口装饰、窗口列表、任务栏等），本机窗口系统可以使用不同尺寸的不同图像表示一个窗口。也可以对所有上下文使用一个图像，或者根本不用图像。

覆盖：: 类 Frame 中的 setIconImage

参数：: image - 要显示的图标图像。
另请参见：: Window.setIconImages(java.util.List extends java.awt.Image>), Window.getIconImages()

getContentPane

public Container getContentPane()

返回此窗体的 contentPane 对象

指定者：: 接口 RootPaneContainer 中的 getContentPane

返回：: contentPane 属性
另请参见：: setContentPane(java.awt.Container), RootPaneContainer.getContentPane()

setContentPane

public void setContentPane(Container contentPane)

设置 contentPane 属性。此方法由构造方法调用。

Swing 的绘制架构要求在包含层次结构中有不透明的 JComponent。这通常由内容窗格提供。如果要替换内容窗格，建议用不透明的 JComponent 替换它。

指定者：: 接口 RootPaneContainer 中的 setContentPane

参数：: contentPane - 此窗体的 contentPane 对象
抛出：: IllegalComponentStateException - （运行时异常）如果 contentPane 参数为 null
另请参见：: getContentPane(), RootPaneContainer.setContentPane(java.awt.Container), JRootPane

getLayeredPane

public JLayeredPane getLayeredPane()

返回此窗体的 layeredPane 对象。

指定者：: 接口 RootPaneContainer 中的 getLayeredPane

返回：: layeredPane 属性
另请参见：: setLayeredPane(javax.swing.JLayeredPane), RootPaneContainer.getLayeredPane()

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

设置 layeredPane 属性。此方法由构造方法调用。

指定者：: 接口 RootPaneContainer 中的 setLayeredPane

参数：: layeredPane - 此窗体的 layeredPane 对象
抛出：: IllegalComponentStateException - （运行时异常）如果 layeredPane 参数为 null
另请参见：: getLayeredPane(), RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()

返回此窗体的 glassPane 对象。

指定者：: 接口 RootPaneContainer 中的 getGlassPane

返回：: glassPane 属性
另请参见：: setGlassPane(java.awt.Component), RootPaneContainer.getGlassPane()

setGlassPane

public void setGlassPane(Component glassPane)

设置 glassPane 属性。此方法由构造方法调用。

指定者：: 接口 RootPaneContainer 中的 setGlassPane

参数：: glassPane - 此窗体的 glassPane 对象
另请参见：: getGlassPane(), RootPaneContainer.setGlassPane(java.awt.Component)

getGraphics

public Graphics getGraphics()

为组件创建一个图形上下文。如果组件当前是不可显示的，则此方法返回 null。

覆盖：: 类 Component 中的 getGraphics

返回：: 组件的图形上下文，如果其没有，则返回 null
从以下版本开始：: 1.6
另请参见：: Component.paint(java.awt.Graphics)

repaint

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

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

覆盖：: 类 Component 中的 repaint

参数：: time - 更新前等待的最长时间（以毫秒为单位）; x - x 坐标; y - y 坐标; width - 宽度; height - 高度

从以下版本开始：

1.6

另请参见：

RepaintManager

setDefaultLookAndFeelDecorated

public static void setDefaultLookAndFeelDecorated(boolean defaultLookAndFeelDecorated)

提供一个关于新创建的 JFrame 是否应该具有当前外观为其提供的 Window 装饰（如边框、关闭窗口的小部件、标题等等）的提示。如果 defaultLookAndFeelDecorated 为 true，则当前的 LookAndFeel 支持提供窗口装饰，并且当前的窗口管理器支持未装饰的窗口，然后新创建的 JFrame 将具有当前 LookAndFeel 为其提供的 Window 装饰。否则，新创建的 JFrame 将具有当前窗口管理器为其提供的 Window 装饰。

执行以下操作可在单个 JFrame 上获得相同的效果：

    JFrame frame = new JFrame();
    frame.setUndecorated(true);
    frame.getRootPane().setWindowDecorationStyle(JRootPane.FRAME);

参数：: defaultLookAndFeelDecorated - 指示当前的外观是否应该提供窗口装饰的提示
从以下版本开始：: 1.4
另请参见：: LookAndFeel.getSupportsWindowDecorations()

isDefaultLookAndFeelDecorated

public static boolean isDefaultLookAndFeelDecorated()

如果新创建的 JFrame 应该由当前外观为其提供 Window 装饰，则返回 true。这只是一个提示，因为某些外观可能不支持此功能。

返回：: 如果外观应该提供 Window 装饰，则返回 true。
从以下版本开始：: 1.4

paramString

protected String paramString()

返回此 JFrame 的字符串表示形式。此方法仅在进行调试的时候使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：: 类 Frame 中的 paramString

返回：: 此 JFrame 的字符串表示形式

getAccessibleContext

public AccessibleContext getAccessibleContext()

获得与此 JFrame 关联的 AccessibleContext。对于 JFrame，AccessibleContext 采用 AccessibleJFrame 的形式。如有必要，可创建一个新的 AccessibleJFrame 实例。

指定者：: 接口 Accessible 中的 getAccessibleContext
覆盖：: 类 Frame 中的 getAccessibleContext

返回：: 一个 AccessibleJFrame，它充当此 JFrame 的 AccessibleContext

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

javax.swing 类 JFrame

EXIT_ON_CLOSE

rootPane

rootPaneCheckingEnabled

accessibleContext

JFrame

JFrame

JFrame

JFrame

frameInit

createRootPane

processWindowEvent

setDefaultCloseOperation

getDefaultCloseOperation

setTransferHandler

getTransferHandler

update

setJMenuBar

getJMenuBar

isRootPaneCheckingEnabled

setRootPaneCheckingEnabled

addImpl

remove

setLayout

getRootPane

setRootPane

setIconImage

getContentPane

setContentPane

getLayeredPane

setLayeredPane

getGlassPane

setGlassPane

getGraphics

repaint

setDefaultLookAndFeelDecorated

isDefaultLookAndFeelDecorated

paramString

getAccessibleContext

javax.swing
类 JFrame