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

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

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

窗体的默认布局为 BorderLayout。

使用 setUndecorated，窗体可以关闭本机装饰（即 Frame 和 Titlebar）。但只有在窗体不是 displayable 时才能这样做。

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

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

在此环境中调用 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);
 

窗体能够生成以下类型的 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), 序列化表格

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

窗体处于 "normal" 状态。此符号常量指定所有状态位均被清除的窗体状态。

另请参见：

setExtendedState(int), getExtendedState(), 常量字段值

ICONIFIED

public static final int ICONIFIED

此状态位指示将窗体图标化。

另请参见：

setExtendedState(int), getExtendedState(), 常量字段值

MAXIMIZED_HORIZ

public static final int MAXIMIZED_HORIZ

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

从以下版本开始：

1.4

另请参见：

setExtendedState(int), getExtendedState(), 常量字段值

MAXIMIZED_VERT

public static final int MAXIMIZED_VERT

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

从以下版本开始：

1.4

另请参见：

setExtendedState(int), getExtendedState(), 常量字段值

MAXIMIZED_BOTH

public static final int MAXIMIZED_BOTH

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

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

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

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

     (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 不是来自屏幕设备。

HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true 时

从以下版本开始：

1.3

另请参见：

GraphicsEnvironment.isHeadless()

Frame

public Frame(String title)
      throws HeadlessException

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

参数：

title - 要显示在窗体边框中的标题。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 - 要显示在窗体边框中的标题。null 值视为空字符串 ""。

gc - 目标屏幕设备的 GraphicsConfiguration。如果 gc 为 null，则假定它为系统默认的 GraphicsConfiguration。

抛出：

IllegalArgumentException - 如果 gc 不是来自屏幕设备。

HeadlessException - 当 GraphicsEnvironment.isHeadless() 返回 true 时

从以下版本开始：

1.3

另请参见：

GraphicsEnvironment.isHeadless(), Component.setSize(int, int), Component.setVisible(boolean), GraphicsConfiguration.getBounds()

addNotify

public void addNotify()

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

覆盖：

类 Window 中的 addNotify

另请参见：

Component.isDisplayable(), removeNotify()

getTitle

public String getTitle()

获得窗体的标题。标题显示在窗体的边框中。

返回：

此窗体的标题，如果此窗体没有标题，则返回一个空字符串 ("") 。

另请参见：

setTitle(String)

setTitle

public void setTitle(String title)

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

参数：

title - 要显示在窗体边框中的标题。null 值视为空字符串 ""。

另请参见：

getTitle()

getIconImage

public Image getIconImage()

返回要作为此窗体图标显示的图像。

此方法已废弃，保留它只是为了向后兼容性。使用 Window.getIconImages() 代替。

如果将几个图像的列表指定为 Window 的图标，则此方法返回列表的第一项。

返回：

此窗体的图标图像；如果此窗体没有图标图像，则返回 null。

另请参见：

setIconImage(Image), Window.getIconImages(), Window.setIconImages(java.util.List)

setIconImage

public void setIconImage(Image image)

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

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

以下语句：

     setIconImage(image);
 

等价于：

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

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

覆盖：

类 Window 中的 setIconImage

参数：

image - 要显示的图标图像。

另请参见：

Window.setIconImages(java.util.List), Window.getIconImages()

getMenuBar

public MenuBar getMenuBar()

获取此窗体的菜单栏。

返回：

此窗体的菜单栏；如果此窗体没有菜单栏，则返回 null。

另请参见：

setMenuBar(MenuBar)

setMenuBar

public void setMenuBar(MenuBar mb)

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

参数：

mb - 正被设置的菜单栏。如果此参数为 null，则移除此窗体上现有的所有菜单栏。

另请参见：

getMenuBar()

isResizable

public boolean isResizable()

指示此窗体是否可由用户调整大小。在默认情况下，所有窗体最初都可以调整大小。

返回：

如果用户可以调整窗体的大小，则返回 true；否则返回 false。

另请参见：

setResizable(boolean)

setResizable

public void setResizable(boolean resizable)

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

参数：

resizable - 如果此窗体是可调整大小的，则为 true；否则为 false。

另请参见：

isResizable()

setState

public void setState(int state)

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

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

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

参数：

state - Frame.NORMAL 或 Frame.ICONIFIED。

另请参见：

getState(), setExtendedState(int)

setExtendedState

public void setExtendedState(int state)

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

• NORMAL
  指示不设置任何状态位。
• ICONIFIED
• MAXIMIZED_HORIZ
• MAXIMIZED_VERT
• MAXIMIZED_BOTH
  串连 MAXIMIZED_HORIZ 和 MAXIMIZED_VERT。

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

参数：

state - 窗体状态常量的逐位掩码

从以下版本开始：

1.4

另请参见：

getExtendedState(), Toolkit.isFrameStateSupported(int)

getState

public int getState()

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

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

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

返回：

Frame.NORMAL 或 Frame.ICONIFIED。

另请参见：

setState(int), getExtendedState()

getExtendedState

public int getExtendedState()

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

• NORMAL
  指示不设置任何状态位。
• ICONIFIED
• MAXIMIZED_HORIZ
• MAXIMIZED_VERT
• MAXIMIZED_BOTH
  串连 MAXIMIZED_HORIZ 和 MAXIMIZED_VERT。

返回：

窗体状态常量的逐位掩码

从以下版本开始：

1.4

另请参见：

setExtendedState(int)

setMaximizedBounds

public void setMaximizedBounds(Rectangle bounds)

设置此窗体的最大化边界。

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

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

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

参数：

bounds - 最大化状态的边界

从以下版本开始：

1.4

另请参见：

getMaximizedBounds()

getMaximizedBounds

public Rectangle getMaximizedBounds()

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

返回：

此窗体的最大化边界；可以为 null

从以下版本开始：

1.4

另请参见：

setMaximizedBounds(Rectangle)

setUndecorated

public void setUndecorated(boolean undecorated)

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

参数：

undecorated - 如果没有启用窗体装饰，则为 true；如果启用了窗体装饰，则为 false。

抛出：

IllegalComponentStateException - 如果窗体是可显示的。

从以下版本开始：

1.4

另请参见：

isUndecorated(), Component.isDisplayable(), JFrame.setDefaultLookAndFeelDecorated(boolean)

isUndecorated

public boolean isUndecorated()

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

返回：

如果窗体未装饰，则返回 true；否则返回 false。

从以下版本开始：

1.4

另请参见：

setUndecorated(boolean)

remove

public void remove(MenuComponent m)

从此窗体移除指定的菜单栏。

指定者：

接口 MenuContainer 中的 remove

覆盖：

类 Component 中的 remove

参数：

m - 要移除的菜单组件。如果 m 为 null，则不执行任何操作。

另请参见：

Component.add(PopupMenu)

removeNotify

public void removeNotify()

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

覆盖：

类 Window 中的 removeNotify

另请参见：

Component.isDisplayable(), addNotify()

paramString

protected String paramString()

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

覆盖：

类 Container 中的 paramString

返回：

此窗体的参数字符串

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。

警告： 此方法可能返回系统创建的窗体，如 Swing 使用的共享的、隐藏的窗体。应用程序不应该假定这些窗口存在，也不应该假定与这些窗体有关的任何内容（如组件位置、LayoutManager 或序列化）存在。

注：若要获得没有所有者的窗口列表，包括没有所有者的 Dialog（在版本 1.6 中引入），请使用 Window.getOwnerlessWindows。

从以下版本开始：

1.2

另请参见：

Window.getWindows(sun.awt.AppContext), Window.getOwnerlessWindows()

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

指定者：

接口 Accessible 中的 getAccessibleContext

覆盖：

类 Window 中的 getAccessibleContext

返回：

用作此窗体 AccessibleContext 的 AccessibleAWTFrame。

从以下版本开始：

1.3

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。