WindowEvent (Java 2 Platform SE 6)

概觀

軟體套件

類別

使用

階層樹

已過時

索引

說明

Java^TM 2 Platform
Standard Ed. 6

上一個類別 下一個類別

框架 無框架

摘要：巢狀 | 欄位 | 建構子 | 方法

詳細資訊：欄位 | 建構子 | 方法

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, 序列化表格

欄位摘要
`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.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
從以下版本開始：: 1.4

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. 6

上一個類別 下一個類別

框架 無框架

摘要：巢狀 | 欄位 | 建構子 | 方法

詳細資訊：欄位 | 建構子 | 方法

提交錯誤或意見

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