所有类

概述 软件包  类 使用 树 已过时 索引 帮助 
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

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 是带有标题和边界的顶层窗口。

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  classFrame.AccessibleAWTFrame
          此类实现对 Frame 类的可访问性支持。
 
从类 java.awt.Window 继承的嵌套类/接口
Window.AccessibleAWTWindow
 
从类 java.awt.Container 继承的嵌套类/接口
Container.AccessibleAWTContainer
 
从类 java.awt.Component 继承的嵌套类/接口
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
字段摘要
static intCROSSHAIR_CURSOR
          已过时。 由 Cursor.CROSSHAIR_CURSOR 取代。
static intDEFAULT_CURSOR
          已过时。 由 Cursor.DEFAULT_CURSOR 取代。
static intE_RESIZE_CURSOR
          已过时。 由 Cursor.E_RESIZE_CURSOR 取代。
static intHAND_CURSOR
          已过时。 由 Cursor.HAND_CURSOR 取代。
static intICONIFIED
          此状态位指示将 frame 图标化。
static intMAXIMIZED_BOTH
          此状态位掩码指示将 frame 完全最大化（水平和垂直方向）。
static intMAXIMIZED_HORIZ
          此状态位指示在水平方向将 frame 最大化。
static intMAXIMIZED_VERT
          此状态位指示在垂直方向将 frame 最大化。
static intMOVE_CURSOR
          已过时。 由 Cursor.MOVE_CURSOR 取代。
static intN_RESIZE_CURSOR
          已过时。 由 Cursor.N_RESIZE_CURSOR 取代。
static intNE_RESIZE_CURSOR
          已过时。 由 Cursor.NE_RESIZE_CURSOR 取代。
static intNORMAL
          Frame 处于 "normal" 状态。
static intNW_RESIZE_CURSOR
          已过时。 由 Cursor.NW_RESIZE_CURSOR 取代。
static intS_RESIZE_CURSOR
          已过时。 由 Cursor.S_RESIZE_CURSOR 取代。
static intSE_RESIZE_CURSOR
          已过时。 由 Cursor.SE_RESIZE_CURSOR 取代。
static intSW_RESIZE_CURSOR
          已过时。 由 Cursor.SW_RESIZE_CURSOR 取代。
static intTEXT_CURSOR
          已过时。 由 Cursor.TEXT_CURSOR 取代。
static intW_RESIZE_CURSOR
          已过时。 由 Cursor.W_RESIZE_CURSOR 取代。
static intWAIT_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 对象。
 
方法摘要
 voidaddNotify()
          通过将此 Frame 连接到本机屏幕资源，从而使其成为可显示的。
protected  voidfinalize()
          移除输入方法和上下文，并从 AppContext 中移除此 Frame。
 AccessibleContextgetAccessibleContext()
          获取与此 Frame 有关的 AccessibleContext。
 intgetCursorType()
          已过时。 从 JDK version 1.1 开始，由 Component.getCursor() 取代。
 intgetExtendedState()
          获取此 frame 的状态。
static Frame[]getFrames()
          返回一个数组，包含由应用程序创建的所有 Frame。
 ImagegetIconImage()
          获取此 frame 显示在最小化图标中的图像。
 RectanglegetMaximizedBounds()
          获取此 frame 的最大化边界。
 MenuBargetMenuBar()
          获取此 frame 的菜单栏。
 intgetState()
          获取此 frame 的状态（已废弃）。
 StringgetTitle()
          获得 frame 的标题。
 booleanisResizable()
          指示此 frame 是否可由用户调整大小。
 booleanisUndecorated()
          指示此 frame 是否未装饰。
protected  StringparamString()
          返回表示此 Frame 状态的字符串。
 voidremove(MenuComponent m)
          从此 frame 移除指定的菜单栏。
 voidremoveNotify()
          通过移除与本机屏幕资源的连接，将此 Frame 设置为不可显示的。
 voidsetCursor(int cursorType)
          已过时。 从 JDK version 1.1 开始，由 Component.setCursor(Cursor) 取代。
 voidsetExtendedState(int state)
          设置此 frame 的状态。
 voidsetIconImage(Image image)
          设置此 frame 要显示在最小化图标中的图像。
 voidsetMaximizedBounds(Rectangle bounds)
          设置此 frame 的最大化边界。
 voidsetMenuBar(MenuBar mb)
          将此 frame 的菜单栏设置为指定的菜单栏。
 voidsetResizable(boolean resizable)
          设置此 frame 是否可由用户调整大小。
 voidsetState(int state)
          设置此 frame 的状态（已废弃）。
 voidsetTitle(String title)
          将此 frame 的标题设置为指定的字符串。
 voidsetUndecorated(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 取代。
另请参见：
常量字段值