Frame (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

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

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

java.awt
类 Frame

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Frame

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

直接已知子类：: JFrame

public class Frame
extends Window
implements MenuContainer
extends Window
implements MenuContainer

Frame 是带有标题和边界的顶层窗口。

frame 的大小包括边界指定的所有区域。边界区域的尺寸可以使用 getInsets 方法获得，但是，由于这些尺寸是与平台相关的，因此在通过调用 pack 或 show 将 frame 设置为可显示的之前，无法获得有效的 insets 值。由于 frame 的总大小包括了边界区，因此边界有效地模糊了 frame 的部分区域，约束了可用于在矩形中呈现和/或显示子部件的区域，矩形左上角的位置为 (insets.left, insets.top)，宽度为 width - (insets.left + insets.right)，长度为 height - (insets.top + insets.bottom)。

frame 的默认布局为 BorderLayout。

使用 setUndecorated，frame 可以关闭本机装饰（例如 Frame 和 Titlebar）。只有在 frame 不是 displayable 时才能完成此操作。

在多屏幕环境中，通过使用 Frame(GraphicsConfiguration) 或 Frame(String title, GraphicsConfiguration) 构造 Frame，可以在不同的屏幕设备上创建 Frame。GraphicsConfiguration 对象是目标屏幕设备的 GraphicsConfiguration 对象之一。

在虚拟设备多屏幕环境中（其中桌面区域可以跨越多物理屏幕设备），所有配置的边界都是相对于虚拟坐标系统的。虚拟坐标系统的原点位于主物理屏幕的左上角。是否使用负坐标，取决于主物理屏幕在虚拟设备中的位置，如下图所示。

包括三个物理屏幕和一个主物理屏幕的虚拟设备。主物理屏幕
显示坐标为 (0,0)，而另一个物理屏幕显示坐标为 (-80,-100)。

在此环境中，调用 setLocation 时，必须传递一个虚拟坐标到此方法中。类似地，对 Frame 调用 getLocationOnScreen 将返回虚拟设备坐标。调用 GraphicsConfiguration 的 getBounds 方法，以查找它在虚拟坐标系统中的原点。

以下代码将 Frame 的位置设置为 (10, 10)（相对于相应的 GraphicsConfiguration 的物理屏幕的原点）。如果不考虑 GraphicsConfiguration 的边界，则 Frame 的位置将被设置为 (10, 10)（相对于虚拟坐标系统），并出现在主物理屏幕上，主物理屏幕不同于指定的 GraphicsConfiguration 的物理屏幕。

      Frame f = new Frame(GraphicsConfiguration gc);
      Rectangle bounds = gc.getBounds();
      f.setLocation(10 + bounds.x, 10 + bounds.y);

Frame 能够产生以下类型的 WindowEvent：

WINDOW_OPENED
WINDOW_CLOSING:
在处理事件时，如果程序没有显式地隐藏或移除窗口，则取消窗口关闭操作。
WINDOW_CLOSED
WINDOW_ICONIFIED
WINDOW_DEICONIFIED
WINDOW_ACTIVATED
WINDOW_DEACTIVATED
WINDOW_GAINED_FOCUS
WINDOW_LOST_FOCUS
WINDOW_STATE_CHANGED

从以下版本开始：: JDK1.0
另请参见：: WindowEvent, Window.addWindowListener(java.awt.event.WindowListener), 序列化表格

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

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

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

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

字段摘要
`static int`	`CROSSHAIR_CURSOR` 已过时。由 `Cursor.CROSSHAIR_CURSOR` 取代。
`static int`	`DEFAULT_CURSOR` 已过时。由 `Cursor.DEFAULT_CURSOR` 取代。
`static int`	`E_RESIZE_CURSOR` 已过时。由 `Cursor.E_RESIZE_CURSOR` 取代。
`static int`	`HAND_CURSOR` 已过时。由 `Cursor.HAND_CURSOR` 取代。
`static int`	`ICONIFIED` 此状态位指示将 frame 图标化。
`static int`	`MAXIMIZED_BOTH` 此状态位掩码指示将 frame 完全最大化（水平和垂直方向）。
`static int`	`MAXIMIZED_HORIZ` 此状态位指示在水平方向将 frame 最大化。
`static int`	`MAXIMIZED_VERT` 此状态位指示在垂直方向将 frame 最大化。
`static int`	`MOVE_CURSOR` 已过时。由 `Cursor.MOVE_CURSOR` 取代。
`static int`	`N_RESIZE_CURSOR` 已过时。由 `Cursor.N_RESIZE_CURSOR` 取代。
`static int`	`NE_RESIZE_CURSOR` 已过时。由 `Cursor.NE_RESIZE_CURSOR` 取代。
`static int`	`NORMAL` Frame 处于 "normal" 状态。
`static int`	`NW_RESIZE_CURSOR` 已过时。由 `Cursor.NW_RESIZE_CURSOR` 取代。
`static int`	`S_RESIZE_CURSOR` 已过时。由 `Cursor.S_RESIZE_CURSOR` 取代。
`static int`	`SE_RESIZE_CURSOR` 已过时。由 `Cursor.SE_RESIZE_CURSOR` 取代。
`static int`	`SW_RESIZE_CURSOR` 已过时。由 `Cursor.SW_RESIZE_CURSOR` 取代。
`static int`	`TEXT_CURSOR` 已过时。由 `Cursor.TEXT_CURSOR` 取代。
`static int`	`W_RESIZE_CURSOR` 已过时。由 `Cursor.W_RESIZE_CURSOR` 取代。
`static int`	`WAIT_CURSOR` 已过时。由 `Cursor.WAIT_CURSOR` 取代。

从类 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`

构造方法摘要
`Frame()` 构造 `Frame` 的一个新实例（初始时不可见）。
`Frame(GraphicsConfiguration gc)` 使用屏幕设备的指定 `GraphicsConfiguration` 创建一个 `Frame`。
`Frame(String title)` 构造一个新的、初始不可见的、具有指定标题的 `Frame` 对象。
`Frame(String title, GraphicsConfiguration gc)` 构造一个新的、初始不可见的、具有指定标题和 `GraphicsConfiguration` 的 `Frame` 对象。

方法摘要
`void`	`addNotify()` 通过将此 Frame 连接到本机屏幕资源，从而使其成为可显示的。
`protected void`	`finalize()` 移除输入方法和上下文，并从 AppContext 中移除此 Frame。
`AccessibleContext`	`getAccessibleContext()` 获取与此 Frame 有关的 AccessibleContext。
`int`	`getCursorType()` 已过时。从 JDK version 1.1 开始，由 `Component.getCursor()` 取代。
`int`	`getExtendedState()` 获取此 frame 的状态。
`static Frame[]`	`getFrames()` 返回一个数组，包含由应用程序创建的所有 Frame。
`Image`	`getIconImage()` 获取此 frame 显示在最小化图标中的图像。
`Rectangle`	`getMaximizedBounds()` 获取此 frame 的最大化边界。
`MenuBar`	`getMenuBar()` 获取此 frame 的菜单栏。
`int`	`getState()` 获取此 frame 的状态（已废弃）。
`String`	`getTitle()` 获得 frame 的标题。
`boolean`	`isResizable()` 指示此 frame 是否可由用户调整大小。
`boolean`	`isUndecorated()` 指示此 frame 是否未装饰。
`protected String`	`paramString()` 返回表示此 `Frame` 状态的字符串。
`void`	`remove(MenuComponent m)` 从此 frame 移除指定的菜单栏。
`void`	`removeNotify()` 通过移除与本机屏幕资源的连接，将此 Frame 设置为不可显示的。
`void`	`setCursor(int cursorType)` 已过时。从 JDK version 1.1 开始，由 `Component.setCursor(Cursor)` 取代。
`void`	`setExtendedState(int state)` 设置此 frame 的状态。
`void`	`setIconImage(Image image)` 设置此 frame 要显示在最小化图标中的图像。
`void`	`setMaximizedBounds(Rectangle bounds)` 设置此 frame 的最大化边界。
`void`	`setMenuBar(MenuBar mb)` 将此 frame 的菜单栏设置为指定的菜单栏。
`void`	`setResizable(boolean resizable)` 设置此 frame 是否可由用户调整大小。
`void`	`setState(int state)` 设置此 frame 的状态（已废弃）。
`void`	`setTitle(String title)` 将此 frame 的标题设置为指定的字符串。
`void`	`setUndecorated(boolean undecorated)` 禁用或启用此 frame 的装饰。

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

从类 java.awt.Container 继承的方法
add, add, add, add, add, addContainerListener, addImpl, 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, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, 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, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, 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, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

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

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

字段详细信息

DEFAULT_CURSOR

@Deprecated
public static final int DEFAULT_CURSOR

已过时。 由 Cursor.DEFAULT_CURSOR 取代。

另请参见：: 常量字段值

CROSSHAIR_CURSOR

@Deprecated
public static final int CROSSHAIR_CURSOR

已过时。 由 Cursor.CROSSHAIR_CURSOR 取代。

另请参见：: 常量字段值

TEXT_CURSOR

@Deprecated
public static final int TEXT_CURSOR

已过时。 由 Cursor.TEXT_CURSOR 取代。

另请参见：: 常量字段值

WAIT_CURSOR

@Deprecated
public static final int WAIT_CURSOR

已过时。 由 Cursor.WAIT_CURSOR 取代。

另请参见：: 常量字段值

SW_RESIZE_CURSOR

@Deprecated
public static final int SW_RESIZE_CURSOR

已过时。 由 Cursor.SW_RESIZE_CURSOR 取代。

另请参见：: 常量字段值

SE_RESIZE_CURSOR

@Deprecated
public static final int SE_RESIZE_CURSOR

已过时。 由 Cursor.SE_RESIZE_CURSOR 取代。

另请参见：: 常量字段值

NW_RESIZE_CURSOR

@Deprecated
public static final int NW_RESIZE_CURSOR

已过时。 由 Cursor.NW_RESIZE_CURSOR 取代。

另请参见：: 常量字段值

NE_RESIZE_CURSOR

@Deprecated
public static final int NE_RESIZE_CURSOR

已过时。 由 Cursor.NE_RESIZE_CURSOR 取代。

另请参见：: 常量字段值

N_RESIZE_CURSOR

@Deprecated
public static final int N_RESIZE_CURSOR

已过时。 由 Cursor.N_RESIZE_CURSOR 取代。

另请参见：: 常量字段值

S_RESIZE_CURSOR

@Deprecated
public static final int S_RESIZE_CURSOR

已过时。 由 Cursor.S_RESIZE_CURSOR 取代。

另请参见：: 常量字段值

W_RESIZE_CURSOR

@Deprecated
public static final int W_RESIZE_CURSOR

已过时。 由 Cursor.W_RESIZE_CURSOR 取代。

另请参见：: 常量字段值

E_RESIZE_CURSOR

@Deprecated
public static final int E_RESIZE_CURSOR

已过时。 由 Cursor.E_RESIZE_CURSOR 取代。

另请参见：: 常量字段值

HAND_CURSOR

@Deprecated
public static final int HAND_CURSOR

已过时。 由 Cursor.HAND_CURSOR 取代。

另请参见：: 常量字段值

MOVE_CURSOR

@Deprecated
public static final int MOVE_CURSOR

已过时。 由 Cursor.MOVE_CURSOR 取代。

另请参见：: 常量字段值

NORMAL

public static final int NORMAL

Frame 处于 "normal" 状态。此符号常量命名了一个 frame 状态，所有状态位均被清除。

另请参见：: setExtendedState(int), getExtendedState(), 常量字段值

ICONIFIED

public static final int ICONIFIED

此状态位指示将 frame 图标化。

另请参见：: setExtendedState(int), getExtendedState(), 常量字段值

MAXIMIZED_HORIZ

public static final int MAXIMIZED_HORIZ

此状态位指示在水平方向将 frame 最大化。

从以下版本开始：: 1.4
另请参见：: setExtendedState(int), getExtendedState(), 常量字段值

MAXIMIZED_VERT

public static final int MAXIMIZED_VERT

此状态位指示在垂直方向将 frame 最大化。

从以下版本开始：: 1.4
另请参见：: setExtendedState(int), getExtendedState(), 常量字段值

MAXIMIZED_BOTH

public static final int MAXIMIZED_BOTH

此状态位掩码指示将 frame 完全最大化（水平和垂直方向）。它只是 MAXIMIZED_VERT | MAXIMIZED_HORIZ 的一种便捷替代方式。

注意，要正确测试 frame 是否完全最大化，使用以下方法：

     (state & Frame.MAXIMIZED_BOTH) == Frame.MAXIMIZED_BOTH

要测试 frame 是否在某个方向最大化，使用：

     (state & Frame.MAXIMIZED_BOTH) != 0

从以下版本开始：: 1.4
另请参见：: setExtendedState(int), getExtendedState(), 常量字段值

构造方法详细信息

Frame

public Frame()
      throws HeadlessException

构造 Frame 的一个新实例（初始时不可见）。Frame 的标题为空。

抛出：: HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true 时
另请参见：: GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean)

Frame

public Frame(GraphicsConfiguration gc)

使用屏幕设备的指定 GraphicsConfiguration 创建一个 Frame。

参数：: gc - 目标屏幕设备的 GraphicsConfiguration。如果 gc 为 null，则假定它为系统默认的 GraphicsConfiguration。
抛出：: IllegalArgumentException - 如果 gc 不是来自屏幕设备。当 GraphicsEnvironment.isHeadless() 返回 true 时，总是抛出此异常
从以下版本开始：: 1.3
另请参见：: GraphicsEnvironment.isHeadless()

Frame

public Frame(String title)
      throws HeadlessException

构造一个新的、初始不可见的、具有指定标题的 Frame 对象。

参数：: title - 要显示在 frame 边界中的标题。将 null 值视为空字符串 ""。
抛出：: HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true 时
另请参见：: GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean), GraphicsConfiguration.getBounds()

Frame

public Frame(String title,
             GraphicsConfiguration gc)

构造一个新的、初始不可见的、具有指定标题和 GraphicsConfiguration 的 Frame 对象。

参数：: title - 要显示在 frame 边界中的标题。将 null 值视为空字符串 ""。; gc - 目标屏幕设备的 GraphicsConfiguration。如果 gc 为 null，则假定它为系统默认的 GraphicsConfiguration。
抛出：: IllegalArgumentException - 如果 gc 不是来自屏幕设备。当 GraphicsEnvironment.isHeadless() 返回 true 时，总是抛出此异常
另请参见：: GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean), GraphicsConfiguration.getBounds()

方法详细信息

finalize

protected void finalize()
                 throws Throwable

移除输入方法和上下文，并从 AppContext 中移除此 Frame。重写此方法的子类应该调用 super.finalize()。

覆盖：: 类 Window 中的 finalize

抛出：: Throwable - 此方法抛出的 Exception

addNotify

public void addNotify()

通过将此 Frame 连接到本机屏幕资源，从而使其成为可显示的。如果 frame 是可显示的，则其所有子级也将成为可显示的。此方法由工具包内部调用，不应直接由程序调用。

覆盖：: 类 Window 中的 addNotify

另请参见：: Component.isDisplayable(), removeNotify()

getTitle

public String getTitle()

获得 frame 的标题。标题显示在 frame 的边界中。

返回：: 此 frame 的标题，如果此 frame 没有标题，则返回一个空字符串 ("") 。
另请参见：: setTitle(String)

setTitle

public void setTitle(String title)

将此 frame 的标题设置为指定的字符串。

参数：: title - 要显示在 frame 边界中的标题。将 null 值视为空字符串 ""。
另请参见：: getTitle()

getIconImage

public Image getIconImage()

获取此 frame 显示在最小化图标中的图像。

返回：: 此 frame 的图标图像，如果此 frame 没有图标图像，则返回 null。
另请参见：: setIconImage(Image)

setIconImage

public void setIconImage(Image image)

设置此 frame 要显示在最小化图标中的图像。不是所有平台都支持最小化窗口的概念。

参数：: image - 要显示的图标图像。如果此参数为 null，则将图标图像设置为默认图像，默认图像可能随平台不同而不同。
另请参见：: getIconImage()

getMenuBar

public MenuBar getMenuBar()

获取此 frame 的菜单栏。

返回：: 此 frame 的菜单栏，如果此 frame 没有菜单栏，则返回 null。
另请参见：: setMenuBar(MenuBar)

setMenuBar

public void setMenuBar(MenuBar mb)

将此 frame 的菜单栏设置为指定的菜单栏。

参数：: mb - 正被设置的菜单栏。如果此参数为 null，则移除此 frame 上所有现有的菜单栏。
另请参见：: getMenuBar()

isResizable

public boolean isResizable()

指示此 frame 是否可由用户调整大小。在默认情况下，所有 frame 初始时都是可调整大小的。

返回：: 如果用户可以调整 frame 的大小，则返回 true；否则返回 false。
另请参见：: setResizable(boolean)

setResizable

public void setResizable(boolean resizable)

设置此 frame 是否可由用户调整大小。

参数：: resizable - 如果此 frame 是可调整大小的，则为 true；否则为 false。
另请参见：: isResizable()

setState

public void setState(int state)

设置此 frame 的状态（已废弃）。

在较早的 JDK 版本中，frame 的状态只能为 NORMAL 或 ICONIFIED。自从 JDK 1.4 以来，受支持的 frame 状态集合扩大了，frame 状态表示为逐位掩码。

为了与原有的程序兼容，此方法仍然接受 Frame.NORMAL 和 Frame.ICONIFIED，但它只改变 frame 的图标状态，而不影响 frame 其他方面的状态。

参数：: state - Frame.NORMAL 或 Frame.ICONIFIED。
另请参见：: getState(), setExtendedState(int)

setExtendedState

public void setExtendedState(int state)

设置此 frame 的状态。该状态表示为逐位掩码。

NORMAL
指示不设置状态位。
ICONIFIED
MAXIMIZED_HORIZ
MAXIMIZED_VERT
MAXIMIZED_BOTH
Concatenates MAXIMIZED_HORIZ 和 MAXIMIZED_VERT。

注意，如果该状态在给定平台上不受支持，则什么也不会发生。应用程序可以通过 java.awt.Toolkit#isFrameStateSupported(int state) 方法确定特定的状态是否可用。

参数：: state - frame 状态常量的逐位掩码
从以下版本开始：: 1.4
另请参见：: getExtendedState(), Toolkit.isFrameStateSupported(int)

getState

public int getState()

获取此 frame 的状态（已废弃）。

在较早的 JDK 版本中，frame 的状态只能为 NORMAL 或 ICONIFIED。自从 JDK 1.4 以来，受支持的 frame 状态集合扩大了，frame 状态表示为逐位掩码。

为了与原有的程序兼容，此方法仍然返回 Frame.NORMAL 和 Frame.ICONIFIED，但它只报告 frame 的图标状态，而不报告 frame 其他方面的状态。

返回：: Frame.NORMAL 或 Frame.ICONIFIED。
另请参见：: setState(int), getExtendedState()

getExtendedState

public int getExtendedState()

获取此 frame 的状态。该状态表示为逐位掩码。

NORMAL
指示不设置状态位。
ICONIFIED
MAXIMIZED_HORIZ
MAXIMIZED_VERT
MAXIMIZED_BOTH
Concatenates MAXIMIZED_HORIZ 和 MAXIMIZED_VERT。

返回：: frame 状态常量的逐位掩码
从以下版本开始：: 1.4
另请参见：: setExtendedState(int)

setMaximizedBounds

public void setMaximizedBounds(Rectangle bounds)

设置此 frame 的最大化边界。

当 frame 处于最大化状态时，系统提供默认边界。此方法允许重写系统提供的部分或全部值。

如果 bounds 为 null，则接受系统提供的边界。如果 bound 不为 null，则可以重写系统提供的某些值而接受其他值，这通过将您想从系统接受的那些字段设置为 Integer.MAX_VALUE 来完成。

在某些系统中，只考虑部分边界的大小。

参数：: bounds - 最大化状态的边界
从以下版本开始：: 1.4
另请参见：: getMaximizedBounds()

getMaximizedBounds

public Rectangle getMaximizedBounds()

获取此 frame 的最大化边界。有些字段可能包含 Integer.MAX_VALUE，以指示必须使用系统为该字段提供的值。

返回：: 此 frame 的最大化边界；可以为 null
从以下版本开始：: 1.4
另请参见：: setMaximizedBounds(Rectangle)

setUndecorated

public void setUndecorated(boolean undecorated)

禁用或启用此 frame 的装饰。只有在 frame 不可显示时才调用此方法。

参数：: undecorated - 如果没有启用 frame 装饰，则为 true；如果启用了 frame 装饰，则为 false。
抛出：: IllegalComponentStateException - 如果 frame 是可显示的。
从以下版本开始：: 1.4
另请参见：: isUndecorated(), Component.isDisplayable(), JFrame.setDefaultLookAndFeelDecorated(boolean)

isUndecorated

public boolean isUndecorated()

指示此 frame 是否未装饰。在默认情况下，所有 frame 初始时都是已装饰的。

返回：: 如果 frame 未装饰，则返回 true；否则返回 false。
从以下版本开始：: 1.4
另请参见：: setUndecorated(boolean)

remove

public void remove(MenuComponent m)

从此 frame 移除指定的菜单栏。

指定者：: 接口 MenuContainer 中的 remove
覆盖：: 类 Component 中的 remove

参数：: m - 要移除的菜单组件。如果 m 为 null，则不执行任何操作。
另请参见：: Component.add(PopupMenu)

removeNotify

public void removeNotify()

通过移除与本机屏幕资源的连接，将此 Frame 设置为不可显示的。如果 Frame 是不可显示的，则其所有子级也将成为不可显示的。此方法由工具包内部调用，不应直接由程序调用。

覆盖：: 类 Container 中的 removeNotify

另请参见：: Component.isDisplayable(), addNotify()

paramString

protected String paramString()

返回表示此 Frame 状态的字符串。此方法仅用于调试目的，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：: 类 Container 中的 paramString

返回：: 此 frame 的参数字符串

setCursor

@Deprecated
public void setCursor(int cursorType)

已过时。 从 JDK version 1.1 开始，由 Component.setCursor(Cursor) 取代。

getCursorType

@Deprecated
public int getCursorType()

已过时。 从 JDK version 1.1 开始，由 Component.getCursor() 取代。

getFrames

public static Frame[] getFrames()

返回一个数组，包含由应用程序创建的所有 Frame。如果从 applet 调用，数组将只包括该 applet 可访问的 Frame。

从以下版本开始：: 1.2

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此 Frame 有关的 AccessibleContext。对于 frame，AccessibleContext 采用 AccessibleAWTFrame 的形式。如有必要，创建一个新的 AccessibleAWTFrame 实例。

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

返回：: 一个 AccessibleAWTFrame，它用作此 Frame 的 AccessibleContext

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

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

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

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

Frame (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

java.awt 类 Frame

DEFAULT_CURSOR

CROSSHAIR_CURSOR

TEXT_CURSOR

WAIT_CURSOR

SW_RESIZE_CURSOR

SE_RESIZE_CURSOR

NW_RESIZE_CURSOR

NE_RESIZE_CURSOR

N_RESIZE_CURSOR

S_RESIZE_CURSOR

W_RESIZE_CURSOR

E_RESIZE_CURSOR

HAND_CURSOR

MOVE_CURSOR

NORMAL

ICONIFIED

MAXIMIZED_HORIZ

MAXIMIZED_VERT

MAXIMIZED_BOTH

Frame

Frame

Frame

Frame

finalize

addNotify

getTitle

setTitle

getIconImage

setIconImage

getMenuBar

setMenuBar

isResizable

setResizable

setState

setExtendedState

getState

getExtendedState

setMaximizedBounds

getMaximizedBounds

setUndecorated

isUndecorated

remove

removeNotify

paramString

setCursor

getCursorType

getFrames

getAccessibleContext

java.awt
类 Frame