|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.Container java.awt.Window java.awt.Frame
public class Frame
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
对象之一。
在虚拟设备多屏幕环境中(其中桌面区域可以跨越多物理屏幕设备),所有配置的边界都是相对于虚拟坐标系统的。虚拟坐标系统的原点位于主物理屏幕的左上角。是否使用负坐标,取决于主物理屏幕在虚拟设备中的位置,如下图所示。
在此环境中,调用 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
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.lang.Object 继承的方法 |
---|
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
从接口 java.awt.MenuContainer 继承的方法 |
---|
getFont, postEvent |
字段详细信息 |
---|
@Deprecated public static final int DEFAULT_CURSOR
Cursor.DEFAULT_CURSOR
取代。@Deprecated public static final int CROSSHAIR_CURSOR
Cursor.CROSSHAIR_CURSOR
取代。@Deprecated public static final int TEXT_CURSOR
Cursor.TEXT_CURSOR
取代。@Deprecated public static final int WAIT_CURSOR
Cursor.WAIT_CURSOR
取代。@Deprecated public static final int SW_RESIZE_CURSOR
Cursor.SW_RESIZE_CURSOR
取代。@Deprecated public static final int SE_RESIZE_CURSOR
Cursor.SE_RESIZE_CURSOR
取代。@Deprecated public static final int NW_RESIZE_CURSOR
Cursor.NW_RESIZE_CURSOR
取代。@Deprecated public static final int NE_RESIZE_CURSOR
Cursor.NE_RESIZE_CURSOR
取代。@Deprecated public static final int N_RESIZE_CURSOR
Cursor.N_RESIZE_CURSOR
取代。@Deprecated public static final int S_RESIZE_CURSOR
Cursor.S_RESIZE_CURSOR
取代。@Deprecated public static final int W_RESIZE_CURSOR
Cursor.W_RESIZE_CURSOR
取代。@Deprecated public static final int E_RESIZE_CURSOR
Cursor.E_RESIZE_CURSOR
取代。@Deprecated public static final int HAND_CURSOR
Cursor.HAND_CURSOR
取代。@Deprecated public static final int MOVE_CURSOR
Cursor.MOVE_CURSOR
取代。public static final int NORMAL
setExtendedState(int)
,
getExtendedState()
,
常量字段值public static final int ICONIFIED
setExtendedState(int)
,
getExtendedState()
,
常量字段值public static final int MAXIMIZED_HORIZ
setExtendedState(int)
,
getExtendedState()
,
常量字段值public static final int MAXIMIZED_VERT
setExtendedState(int)
,
getExtendedState()
,
常量字段值public static final int MAXIMIZED_BOTH
MAXIMIZED_VERT | MAXIMIZED_HORIZ
的一种便捷替代方式。
注意,要正确测试 frame 是否完全最大化,使用以下方法:
(state & Frame.MAXIMIZED_BOTH) == Frame.MAXIMIZED_BOTH
要测试 frame 是否在某个 方向最大化,使用:
(state & Frame.MAXIMIZED_BOTH) != 0
setExtendedState(int)
,
getExtendedState()
,
常量字段值构造方法详细信息 |
---|
public Frame() throws HeadlessException
Frame
的一个新实例(初始时不可见)。Frame
的标题为空。
HeadlessException
- 当 GraphicsEnvironment.isHeadless() 返回 true 时GraphicsEnvironment.isHeadless()
,
Component.setSize(int, int)
,
Component.setVisible(boolean)
public Frame(GraphicsConfiguration gc)
GraphicsConfiguration
创建一个 Frame
。
gc
- 目标屏幕设备的 GraphicsConfiguration
。如果 gc
为 null
,则假定它为系统默认的 GraphicsConfiguration
。
IllegalArgumentException
- 如果 gc
不是来自屏幕设备。当 GraphicsEnvironment.isHeadless() 返回 true 时,总是抛出此异常GraphicsEnvironment.isHeadless()
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()
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()
方法详细信息 |
---|
protected void finalize() throws Throwable
Window
中的 finalize
Throwable
- 此方法抛出的 Exception
public void addNotify()
Window
中的 addNotify
Component.isDisplayable()
,
removeNotify()
public String getTitle()
setTitle(String)
public void setTitle(String title)
title
- 要显示在 frame 边界中的标题。将 null
值视为空字符串 ""。getTitle()
public Image getIconImage()
null
。setIconImage(Image)
public void setIconImage(Image image)
image
- 要显示的图标图像。如果此参数为 null
,则将图标图像设置为默认图像,默认图像可能随平台不同而不同。getIconImage()
public MenuBar getMenuBar()
null
。setMenuBar(MenuBar)
public void setMenuBar(MenuBar mb)
mb
- 正被设置的菜单栏。如果此参数为 null
,则移除此 frame 上所有现有的菜单栏。getMenuBar()
public boolean isResizable()
true
;否则返回 false
。setResizable(boolean)
public void setResizable(boolean resizable)
resizable
- 如果此 frame 是可调整大小的,则为 true
;否则为 false
。isResizable()
public void setState(int state)
在较早的 JDK 版本中,frame 的状态只能为 NORMAL 或 ICONIFIED。自从 JDK 1.4 以来,受支持的 frame 状态集合扩大了,frame 状态表示为逐位掩码。
为了与原有的程序兼容,此方法仍然接受 Frame.NORMAL
和 Frame.ICONIFIED
,但它只改变 frame 的图标状态,而不影响 frame 其他方面的状态。
state
- Frame.NORMAL
或 Frame.ICONIFIED
。getState()
,
setExtendedState(int)
public void setExtendedState(int state)
NORMAL
ICONIFIED
MAXIMIZED_HORIZ
MAXIMIZED_VERT
MAXIMIZED_BOTH
MAXIMIZED_HORIZ
和 MAXIMIZED_VERT
。
注意,如果该状态在给定平台上不受支持,则什么也不会发生。应用程序可以通过 java.awt.Toolkit#isFrameStateSupported(int state)
方法确定特定的状态是否可用。
state
- frame 状态常量的逐位掩码getExtendedState()
,
Toolkit.isFrameStateSupported(int)
public int getState()
在较早的 JDK 版本中,frame 的状态只能为 NORMAL 或 ICONIFIED。自从 JDK 1.4 以来,受支持的 frame 状态集合扩大了,frame 状态表示为逐位掩码。
为了与原有的程序兼容,此方法仍然返回 Frame.NORMAL
和 Frame.ICONIFIED
,但它只报告 frame 的图标状态,而不报告 frame 其他方面的状态。
Frame.NORMAL
或 Frame.ICONIFIED
。setState(int)
,
getExtendedState()
public int getExtendedState()
NORMAL
ICONIFIED
MAXIMIZED_HORIZ
MAXIMIZED_VERT
MAXIMIZED_BOTH
MAXIMIZED_HORIZ
和 MAXIMIZED_VERT
。
setExtendedState(int)
public void setMaximizedBounds(Rectangle bounds)
当 frame 处于最大化状态时,系统提供默认边界。此方法允许重写系统提供的部分或全部值。
如果 bounds
为 null
,则接受系统提供的边界。如果 bound 不为 null
,则可以重写系统提供的某些值而接受其他值,这通过将您想从系统接受的那些字段设置为 Integer.MAX_VALUE
来完成。
在某些系统中,只考虑部分边界的大小。
bounds
- 最大化状态的边界getMaximizedBounds()
public Rectangle getMaximizedBounds()
Integer.MAX_VALUE
,以指示必须使用系统为该字段提供的值。
null
setMaximizedBounds(Rectangle)
public void setUndecorated(boolean undecorated)
undecorated
- 如果没有启用 frame 装饰,则为 true
;如果启用了 frame 装饰,则为 false
。
IllegalComponentStateException
- 如果 frame 是可显示的。isUndecorated()
,
Component.isDisplayable()
,
JFrame.setDefaultLookAndFeelDecorated(boolean)
public boolean isUndecorated()
true
;否则返回 false
。setUndecorated(boolean)
public void remove(MenuComponent m)
MenuContainer
中的 remove
Component
中的 remove
m
- 要移除的菜单组件。如果 m
为 null
,则不执行任何操作。Component.add(PopupMenu)
public void removeNotify()
Container
中的 removeNotify
Component.isDisplayable()
,
addNotify()
protected String paramString()
Frame
状态的字符串。此方法仅用于调试目的,对于各个实现,所返回字符串的内容和格式可能有所不同。返回的字符串可能为空,但不可能为 null
。
Container
中的 paramString
@Deprecated public void setCursor(int cursorType)
Component.setCursor(Cursor)
取代。
@Deprecated public int getCursorType()
Component.getCursor()
取代。
public static Frame[] getFrames()
public AccessibleContext getAccessibleContext()
Accessible
中的 getAccessibleContext
Window
中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。