Java java.awt 类 Window（JDK5）

所有类

java.awt
类 Window

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

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible

直接已知子类：

BasicToolBarUI.DragWindow, Dialog, Frame, JWindow

public class Window
   
   
   
   
   
extends Container
   
   
   
   
   
   
   
   
   
   
implements Accessible
   
   
   
   
   

Window 对象是一个没有边界和菜单栏的顶层窗口。窗口的默认布局是 BorderLayout。

构造窗口时，窗口必须拥有框架、对话框或作为其所有者定义的其他窗口。

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

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

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

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

        Window w = new Window(Window owner, GraphicsConfiguration gc);
        Rectangle bounds = gc.getBounds();
        w.setLocation(10 + bounds.x, 10 + bounds.y);
 

注：顶层窗口（包括 Window、Frame 和 Dialog）的位置和大小受桌面的窗口管理系统的控制。对 setLocation、setSize 和 setBounds 的调用是转发到窗口管理系统的请求（不是指令）。将尽所有努力响应这样的请求。但是，在某些情况下，窗口管理系统可以忽略这样的请求，或修改请求的几何结构，以放置和调整 Window 的大小，使之更好地与桌面设置匹配。由于本地事件处理的异步特性，由 getBounds、getLocation、getLocationOnScreen 和 getSize 返回的结果可能不反映屏幕上 Window 的实际几何结构，直到处理完最后一个请求。在处理后续的请求的过程中，窗口管理系统满足该请求时，这些值可能会相应地改变。

窗口能够生成以下 WindowEvents：WindowOpened、WindowClosed、indowGainedFocus、indowLostFocus。

从以下版本开始：

JDK1.0

另请参见：

WindowEvent, addWindowListener(java.awt.event.WindowListener), BorderLayout, 序列化表格

Window

public Window(Frame owner)

使用指定的 Frame 作为其所有者，构造一个新的不可见窗口。该窗口将不是可聚焦的，除非其所有者正显示在屏幕上。

如果有安全管理程序，那么此方法首先调用安全管理程序的 checkTopLevelWindow 方法（this 作为其参数），以确定是否必须使用警告横幅显示该窗口。

参数：

owner - 要充当所有者的 Frame

抛出：

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是来自屏幕设备

IllegalArgumentException - 如果 owner 为 null；GraphicsEnvironment.isHeadless 返回 true 时，将始终抛出该异常

另请参见：

GraphicsEnvironment.isHeadless(), SecurityManager.checkTopLevelWindow(java.lang.Object), isShowing()

Window

public Window(Window owner)

使用指定 Window 作为其所有者，构造一个新的不可见窗口。该 Window 将不是可聚焦的，除非其最近拥有的 Frame 和 Dialog 正在该屏幕上显示。

如果有安全管理程序，那么此方法首先调用安全管理程序的 checkTopLevelWindow 方法（this 作为其参数），以确定是否必须使用警告横幅显示该窗口。

参数：

owner - 要充当所有者的 Window

抛出：

IllegalArgumentException - 如果 owner 的 GraphicsConfiguration 不是来自屏幕设备

IllegalArgumentException - 如果 owner 为 null。GraphicsEnvironment.isHeadless() 返回 true 时，始终抛出此异常。

从以下版本开始：

1.2

另请参见：

GraphicsEnvironment.isHeadless(), SecurityManager.checkTopLevelWindow(java.lang.Object), isShowing()

Window

public Window(Window owner,
              GraphicsConfiguration gc)

使用指定窗口的作为其所有者和屏幕设备的一个 GraphicsConfiguration，构造一个新的不可见窗口 。该 Window 将不是可聚焦的，除非其最近拥有的 Frame 和 Dialog 正在该屏幕上显示。

如果有安全管理程序，那么此方法首先调用安全管理程序的 checkTopLevelWindow 方法（this 作为其参数），以确定是否必须使用警告横幅显示该窗口。

参数：

owner - 要充当所有者的窗口

gc - 目标屏幕设备的 GraphicsConfiguration；如果 gc 为 null，则使用系统默认的 GraphicsConfiguration

抛出：

IllegalArgumentException - 如果 owner 为 null

IllegalArgumentException - 如果 gc 不是来自屏幕设备；GraphicsEnvironment.isHeadless 返回 true 时，将始终抛出此异常

从以下版本开始：

1.3

另请参见：

GraphicsEnvironment.isHeadless(), SecurityManager.checkTopLevelWindow(java.lang.Object), GraphicsConfiguration.getBounds(), isShowing()

finalize

protected void finalize()
                 throws Throwable

释放输入方法和上下文，并从 GUI 层次结构中移除此 Window。重写此方法的子类应调用 super.finalize()。

覆盖：

类 Object 中的 finalize

抛出：

Throwable - 此方法抛出的 Exception

addNotify

public void addNotify()

通过创建到其本机屏幕资源的连接，使此窗口变得可显示。此方法由工具包在内部进行调用，并且不应由程序直接调用。

覆盖：

类 Container 中的 addNotify

从以下版本开始：

JDK1.0

另请参见：

Component.isDisplayable(), Container.removeNotify()

pack

public void pack()

调整此窗口的大小，以适合其子组件的首选大小和布局。如果该窗口和/或其所有者仍不可显示，则两者在计算首选大小之前变得可显示。在计算首选大小之后，将会验证该 Window。

另请参见：

Component.isDisplayable()

show

@Deprecated
public void show()

已过时。 从 JDK 5 开始，由 Component.setVisible(boolean) 取代。

覆盖：

类 Component 中的 show

hide

@Deprecated
public void hide()

已过时。 从 JDK 5 开始，由 Component.setVisible(boolean) 取代。

覆盖：

类 Component 中的 hide