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

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

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

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

java.awt.event
类 WindowEvent

java.lang.Object
  java.util.EventObject
      java.awt.AWTEvent
          java.awt.event.ComponentEvent
              java.awt.event.WindowEvent

所有已实现的接口：: Serializable

public class WindowEvent
extends ComponentEvent
extends ComponentEvent

指示窗口状态改变的低级别事件。当打开、关闭、激活、停用、图标化或取消图标化 Window 对象时，或者焦点转移到 Window 内或移出 Window 时，由 Window 对象生成此低级别事件。

该事件被传递给每一个使用窗口的 addWindowListener 方法注册以接收这种事件的 WindowListener 或 WindowAdapter 对象。（WindowAdapter 对象实现 WindowListener 接口。）发生事件时，所有此类侦听器对象都将获得此 WindowEvent。

从以下版本开始：: JDK1.1
另请参见：: WindowAdapter, WindowListener, Tutorial: Writing a Window Listener, Reference: The Java Class Libraries (update file), 序列化表格

字段摘要

static int WINDOW_ACTIVATED
          窗口激活事件类型。

static int WINDOW_CLOSED
          窗口关闭事件。

static int WINDOW_CLOSING
          “窗口正在关闭”事件。

static int WINDOW_DEACTIVATED
          窗口停用事件类型。

static int WINDOW_DEICONIFIED
          窗口取消图标化事件类型。

static int WINDOW_FIRST
          用于窗口事件的 id 范围的起始编号。

static int WINDOW_GAINED_FOCUS
          窗口获得焦点事件类型。

static int WINDOW_ICONIFIED
          窗口图标化事件。

static int WINDOW_LAST
          用于窗口事件的 id 范围的结束编号。

static int WINDOW_LOST_FOCUS
          窗口失去焦点事件类型。

static int WINDOW_OPENED
          窗口打开事件。

static int WINDOW_STATE_CHANGED
          窗口状态改变事件类型。

从类 java.awt.event.ComponentEvent 继承的字段

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

从类 java.awt.AWTEvent 继承的字段

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK

从类 java.util.EventObject 继承的字段

source

构造方法摘要

WindowEvent(Window source, int id)
          构造一个 WindowEvent 对象。

WindowEvent(Window source, int id, int oldState, int newState)
          构造一个具有指定的以前和新窗口状态的 WindowEvent 对象。

WindowEvent(Window source, int id, Window opposite)
          构造一个具有指定对应 Window 的 WindowEvent 对象。

WindowEvent(Window source, int id, Window opposite, int oldState, int newState)
          构造一个 WindowEvent 对象。

方法摘要

int getNewState()
          对于 WINDOW_STATE_CHANGED 事件，返回新的窗口状态。

int getOldState()
          对于 WINDOW_STATE_CHANGED 事件，返回以前的窗口状态。

Window getOppositeWindow()
          返回在此焦点或活动性变化中所涉及的其他 Window。

Window getWindow()
          返回事件的发起方。

String paramString()
          返回标识此事件的参数字符串。

从类 java.awt.event.ComponentEvent 继承的方法

getComponent

从类 java.awt.AWTEvent 继承的方法

consume, getID, isConsumed, setSource, toString

从类 java.util.EventObject 继承的方法

getSource

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段摘要
`static int`	`WINDOW_ACTIVATED` 窗口激活事件类型。
`static int`	`WINDOW_CLOSED` 窗口关闭事件。
`static int`	`WINDOW_CLOSING` “窗口正在关闭”事件。
`static int`	`WINDOW_DEACTIVATED` 窗口停用事件类型。
`static int`	`WINDOW_DEICONIFIED` 窗口取消图标化事件类型。
`static int`	`WINDOW_FIRST` 用于窗口事件的 id 范围的起始编号。
`static int`	`WINDOW_GAINED_FOCUS` 窗口获得焦点事件类型。
`static int`	`WINDOW_ICONIFIED` 窗口图标化事件。
`static int`	`WINDOW_LAST` 用于窗口事件的 id 范围的结束编号。
`static int`	`WINDOW_LOST_FOCUS` 窗口失去焦点事件类型。
`static int`	`WINDOW_OPENED` 窗口打开事件。
`static int`	`WINDOW_STATE_CHANGED` 窗口状态改变事件类型。

从类 java.awt.event.ComponentEvent 继承的字段
`COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN`

从类 java.awt.AWTEvent 继承的字段
`ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK`

从类 java.util.EventObject 继承的字段
`source`

构造方法摘要
`WindowEvent(Window source, int id)` 构造一个 `WindowEvent` 对象。
`WindowEvent(Window source, int id, int oldState, int newState)` 构造一个具有指定的以前和新窗口状态的 `WindowEvent` 对象。
`WindowEvent(Window source, int id, Window opposite)` 构造一个具有指定对应 `Window` 的 `WindowEvent` 对象。
`WindowEvent(Window source, int id, Window opposite, int oldState, int newState)` 构造一个 `WindowEvent` 对象。

方法摘要
`int`	`getNewState()` 对于 `WINDOW_STATE_CHANGED` 事件，返回新的窗口状态。
`int`	`getOldState()` 对于 `WINDOW_STATE_CHANGED` 事件，返回以前的窗口状态。
`Window`	`getOppositeWindow()` 返回在此焦点或活动性变化中所涉及的其他 Window。
`Window`	`getWindow()` 返回事件的发起方。
`String`	`paramString()` 返回标识此事件的参数字符串。

从类 java.awt.event.ComponentEvent 继承的方法
`getComponent`

从类 java.awt.AWTEvent 继承的方法
`consume, getID, isConsumed, setSource, toString`

从类 java.util.EventObject 继承的方法
`getSource`

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

字段详细信息

WINDOW_FIRST

public static final int WINDOW_FIRST

用于窗口事件的 id 范围的起始编号。

另请参见：: 常量字段值

WINDOW_OPENED

public static final int WINDOW_OPENED

窗口打开事件。仅在第一次使窗口可见时才传递此事件。

另请参见：: 常量字段值

WINDOW_CLOSING

public static final int WINDOW_CLOSING

“窗口正在关闭”事件。当用户试图从窗口的系统菜单中关闭该窗口时传递此事件。在处理此事件时，如果程序没有显式地隐藏或释放窗口，则取消窗口关闭操作。

另请参见：: 常量字段值

WINDOW_CLOSED

public static final int WINDOW_CLOSED

窗口关闭事件。调用 dispose 使窗口关闭后传递此事件。

另请参见：: 常量字段值

WINDOW_ICONIFIED

public static final int WINDOW_ICONIFIED

窗口图标化事件。窗口从正常状态变为最小化状态时传递此事件。对于很多平台而言，已最小化的窗口将显示为窗口 iconImage 属性中所指定的图标。

另请参见：: Frame.setIconImage(java.awt.Image), 常量字段值

WINDOW_DEICONIFIED

public static final int WINDOW_DEICONIFIED

窗口取消图标化事件类型。窗口从最小化状态变为正常状态时传递此事件。

另请参见：: 常量字段值

WINDOW_ACTIVATED

public static final int WINDOW_ACTIVATED

窗口激活事件类型。Window 成为活动 Window 时传递此事件。只有框架或对话框可以成为活动 Window。本机的窗口操作系统可能使用特殊装饰表示活动 Window 或其子窗口，如突出显示标题栏。活动 Window 要么是聚焦 Window，要么是作为聚焦 Window 所有者的第一个 Frame 或 Dialog。

另请参见：: 常量字段值

WINDOW_DEACTIVATED

public static final int WINDOW_DEACTIVATED

窗口停用事件类型。Window 不再是活动 Window 时传递此事件。只有框架或对话框可以成为活动 Window。本机的窗口操作系统可能使用特殊装饰表示活动 Window 或其子窗口，如突出显示标题栏。活动 Window 要么是聚焦 Window，要么是作为聚焦 Window 所有者的第一个 Frame 或 Dialog。

另请参见：: 常量字段值

WINDOW_GAINED_FOCUS

public static final int WINDOW_GAINED_FOCUS

窗口获得焦点事件类型。Window 成为聚焦 Window，即该 Window 或其某个子组件接收键盘事件时传递此事件。

另请参见：: 常量字段值

WINDOW_LOST_FOCUS

public static final int WINDOW_LOST_FOCUS

窗口失去焦点事件类型。Window 不再是聚焦 Window，即该 Window 或其某个子组件不再接收键盘事件时传递此事件。

另请参见：: 常量字段值

WINDOW_STATE_CHANGED

public static final int WINDOW_STATE_CHANGED

窗口状态改变事件类型。Window 的状态因为图标化、最大化等原因而发生改变时传递此事件。

从以下版本开始：: 1.4
另请参见：: 常量字段值

WINDOW_LAST

public static final int WINDOW_LAST

用于窗口事件的 id 范围的结束编号。

另请参见：: 常量字段值

构造方法详细信息

WindowEvent

public WindowEvent(Window source,
                   int id,
                   Window opposite,
                   int oldState,
                   int newState)

构造一个 WindowEvent 对象。

注意，传递无效的 id 会导致不明确的行为。如果 source 为 null，则此方法抛出 IllegalArgumentException。

参数：: source - 产生该事件的 Window 对象; id - 指示事件类型的整数。; opposite - 焦点或活动性变化中涉及的其他窗口，或者为 null; oldState - 窗口以前的状态，用于窗口状态改变事件; newState - 窗口的新状态，用于窗口状态改变事件
抛出：: IllegalArgumentException - 如果 source 为 null
从以下版本开始：: 1.4

WindowEvent

public WindowEvent(Window source,
                   int id,
                   Window opposite)

构造一个具有指定对应 Window 的 WindowEvent 对象。对应 Window 是此焦点或活动性变化中所涉及的其他 Window。对于 WINDOW_ACTIVATED 或 WINDOW_GAINED_FOCUS 事件，这是失去活动性或焦点的 Window。对于 WINDOW_DEACTIVATED 或 WINDOW_LOST_FOCUS 事件，这是获得活动性或焦点的 Window。如果本机应用程序、不同 VM 中的 Java 应用程序或没有其他 Window 的窗口发生了这种焦点改变，则对应 Window 为 null。

注意，传递无效的 id 会导致不明确的行为。如果 source 为 null，则此方法抛出 IllegalArgumentException。

参数：: source - 产生该事件的 Window 对象; id - WINDOW_ACTIVATED、WINDOW_DEACTIVATED、WINDOW_GAINED_FOCUS 或 WINDOW_LOST_FOCUS。因为其他 WindowEvent 类型事件的对应 Window 总是为 null，所以不希望将此构造方法用于这种类型的事件; opposite - 焦点或活动性变化中涉及的其他 Window，或者为 null
抛出：: IllegalArgumentException - 如果 source 为 null

WindowEvent

public WindowEvent(Window source,
                   int id,
                   int oldState,
                   int newState)

构造一个具有指定的以前和新窗口状态的 WindowEvent 对象。

注意，传递无效的 id 会导致不明确的行为。如果 source 为 null，则此方法抛出 IllegalArgumentException。

参数：: source - 产生该事件的 Window 对象; id - WINDOW_STATE_CHANGED 事件类型。因为对于其他 WindowEvent 事件类型而言，以前和新的窗口状态是无意义的，所以不希望将此构造方法用于其他事件类型。; oldState - 表示以前窗口状态的整数; newState - 表示新窗口状态的整数
抛出：: IllegalArgumentException - 如果 source 为 null
从以下版本开始：: 1.4

WindowEvent

public WindowEvent(Window source,
                   int id)

构造一个 WindowEvent 对象。

注意，传递无效的 id 会导致不明确的行为。如果 source 为 null，则此方法抛出 IllegalArgumentException。

参数：: source - 产生该事件的 Window 对象; id - 指示事件类型的整数
抛出：: IllegalArgumentException - 如果 source 为 null

方法详细信息

getWindow

public Window getWindow()

返回事件的发起方。

返回：: 引起该事件的 Window 对象

getOppositeWindow

public Window getOppositeWindow()

返回在此焦点或活动性变化中所涉及的其他 Window。对于 WINDOW_ACTIVATED 或 WINDOW_GAINED_FOCUS 事件，这是失去活动性或焦点的 Window。对于 WINDOW_DEACTIVATED 或 WINDOW_LOST_FOCUS 事件，这是获得活动性或焦点的 Window。对于所有其他 WindowEvent 类型，或者本机应用程序、不同 VM 或上下文中的 Java 应用程序或没有其他 Window 的窗口发生了焦点或活动性变化，则返回 null。

返回：: 焦点或活动性变化中所涉及的其他 Window，或者为 null
从以下版本开始：: 1.4

getOldState

public int getOldState()

对于 WINDOW_STATE_CHANGED 事件，返回以前的窗口状态。该状态表示为逐位掩码。

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

返回：: 以前窗口状态的逐位掩码
从以下版本开始：: 1.4
另请参见：: Frame.getExtendedState()

getNewState

public int getNewState()

对于 WINDOW_STATE_CHANGED 事件，返回新的窗口状态。该状态表示为逐位掩码。

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

返回：: 新窗口状态的逐位掩码
从以下版本开始：: 1.4
另请参见：: Frame.getExtendedState()

paramString

public String paramString()

返回标识此事件的参数字符串。此方法对于事件记录和调试很有用。

覆盖：: 类 ComponentEvent 中的 paramString

返回：: 标识事件及其属性的字符串

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

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

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

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

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

java.awt.event 类 WindowEvent

WINDOW_FIRST

WINDOW_OPENED

WINDOW_CLOSING

WINDOW_CLOSED

WINDOW_ICONIFIED

WINDOW_DEICONIFIED

WINDOW_ACTIVATED

WINDOW_DEACTIVATED

WINDOW_GAINED_FOCUS

WINDOW_LOST_FOCUS

WINDOW_STATE_CHANGED

WINDOW_LAST

WindowEvent

WindowEvent

WindowEvent

WindowEvent

getWindow

getOppositeWindow

getOldState

getNewState

paramString

java.awt.event
类 WindowEvent