JavaTM 2 Platform
Standard Ed. 6

java.awt.event
類別 ContainerEvent

java.lang.Object
  繼承者 java.util.EventObject
      繼承者 java.awt.AWTEvent
          繼承者 java.awt.event.ComponentEvent
              繼承者 java.awt.event.ContainerEvent
所有已實作的介面:
Serializable

public class ContainerEvent
extends ComponentEvent

指示容器內容因為添加或移除元件而更改的低層級別事件。

這些容器事件“僅”為通知目的而提供;AWT 將自動處理內部容器內容的更改,使程序正常工作,而不管該程序是否接收這些事件。

在向容器物件(比如 Panel)添加元件或從中移除元件時,容器物件將產生此低層級別事件。事件被傳遞給每一個 ContainerListenerContainerAdapter 物件,這些物件使用元件的 addContainerListener 方法註冊,以接收這類別事件。(ContainerAdapter 物件實作 ContainerListener 介面。)當發生該事件時,所有這類別偵聽器對象都獲得此 ContainerEvent

從以下版本開始:
1.1
另請參見:
ContainerAdapter, ContainerListener, Tutorial: Writing a Container Listener, 序列化表格

欄位摘要
static int COMPONENT_ADDED
          此事件指示元件已被添加到容器中。
static int COMPONENT_REMOVED
          此事件指示已從容器中移除元件。
static int CONTAINER_FIRST
          用於容器事件的 id 範圍的起始編號。
static int CONTAINER_LAST
          用於容器事件的 id 範圍的結束編號。
 
從類別 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
 
建構子摘要
ContainerEvent(Component source, int id, Component child)
          建構一個 ContainerEvent 物件。
 
方法摘要
 Component getChild()
          返回受事件影響的元件。
 Container getContainer()
          返回事件的始發者。
 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
 

欄位詳細資訊

CONTAINER_FIRST

public static final int CONTAINER_FIRST
用於容器事件的 id 範圍的起始編號。

另請參見:
常數欄位值

CONTAINER_LAST

public static final int CONTAINER_LAST
用於容器事件的 id 範圍的結束編號。

另請參見:
常數欄位值

COMPONENT_ADDED

public static final int COMPONENT_ADDED
此事件指示元件已被添加到容器中。

另請參見:
常數欄位值

COMPONENT_REMOVED

public static final int COMPONENT_REMOVED
此事件指示已從容器中移除元件。

另請參見:
常數欄位值
建構子詳細資訊

ContainerEvent

public ContainerEvent(Component source,
                      int id,
                      Component child)
建構一個 ContainerEvent 物件。

注意,傳入無效 id 會導致未指定的行為。如果 sourcenull,則此方法拋出 IllegalArgumentException

參數:
source - 發起事件的 Component 物件(容器)
id - 指示事件型別的整數
child - 被添加或移除的元件
拋出:
IllegalArgumentException - 如果 source 為 null
方法詳細資訊

getContainer

public Container getContainer()
返回事件的始發者。

返回:
發起事件的 Container 物件,如果該物件不是一個 Container,則返回 null

getChild

public Component getChild()
返回受事件影響的元件。

返回:
被添加或移除的 Component 物件

paramString

public String paramString()
返回標識此事件的參數字元串。此方法對於事件記錄和除錯很有用。

覆寫:
類別 ComponentEvent 中的 paramString
返回:
標識事件及其屬性的字元串

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only