java.lang.Object java.util.EventObject java.awt.AWTEvent java.awt.event.ComponentEvent java.awt.event.WindowEvent
public class WindowEvent
指示窗口状态改变的低级别事件。当打开、关闭、激活、停用、图标化或取消图标化 Window 对象时,或者焦点转移到 Window 内或移出 Window 时,由 Window 对象生成此低级别事件。
该事件被传递给每一个使用窗口的 addWindowListener
方法注册以接收这种事件的 WindowListener
或 WindowAdapter
对象。(WindowAdapter
对象实现 WindowListener
接口。)发生事件时,所有此类侦听器对象都将获取此 WindowEvent
。
WindowAdapter
,
WindowListener
,
Tutorial: Writing a Window Listener,
序列化表格
字段摘要 | |
---|---|
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.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 |
字段详细信息 |
---|
public static final int WINDOW_FIRST
public static final int WINDOW_OPENED
public static final int WINDOW_CLOSING
public static final int WINDOW_CLOSED
public static final int WINDOW_ICONIFIED
public static final int WINDOW_DEICONIFIED
public static final int WINDOW_ACTIVATED
public static final int WINDOW_DEACTIVATED
public static final int WINDOW_GAINED_FOCUS
public static final int WINDOW_LOST_FOCUS
public static final int WINDOW_STATE_CHANGED
public static final int WINDOW_LAST
构造方法详细信息 |
---|
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
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
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
public WindowEvent(Window source, int id)
WindowEvent
对象。
注意,传递无效的 id
会导致不明确的行为。如果 source
为 null
,则此方法抛出 IllegalArgumentException
。
source
- 产生该事件的
Window
对象
id
- 指示事件类型的整数
IllegalArgumentException
- 如果
source
为 null
方法详细信息 |
---|
public Window getWindow()
public Window getOppositeWindow()
public int getOldState()
WINDOW_STATE_CHANGED
事件,返回以前的窗口状态。该状态表示为逐位掩码。
NORMAL
ICONIFIED
MAXIMIZED_HORIZ
MAXIMIZED_VERT
MAXIMIZED_BOTH
MAXIMIZED_HORIZ
和 MAXIMIZED_VERT
。
Frame.getExtendedState()
public int getNewState()
WINDOW_STATE_CHANGED
事件,返回新的窗口状态。该状态表示为逐位掩码。
NORMAL
ICONIFIED
MAXIMIZED_HORIZ
MAXIMIZED_VERT
MAXIMIZED_BOTH
MAXIMIZED_HORIZ
和 MAXIMIZED_VERT
。
Frame.getExtendedState()
public String paramString()
ComponentEvent
中的
paramString