Question

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）生成。事件被传递给每一个 ContainerListener 或 ContainerAdapter 对象，这些对象使用组件的 addContainerListener 方法注册，以接收这类事件。（ ContainerAdapter 对象实现 ContainerListener 接口。）当发生该事件时，所有这类侦听器对象都获得此 ContainerEvent 。

从以下版本开始：

1.1

另请参见：

ContainerAdapter , ContainerListener , Tutorial: Writing a Container Listener, Reference: The Java Class Libraries (update file), 序列化表格

---

字段摘要
staticint	COMPONENT_ADDED 此事件指示组件已被添加到容器中。
staticint	COMPONENT_REMOVED 此事件指示已从容器中移除组件。
staticint	CONTAINER_FIRST 用于容器事件的 id 范围的起始编号。
staticint	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(Componentsource, intid, Componentchild) 构造一个 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(Componentsource,
                      intid,
                      Componentchild)

构造一个 ContainerEvent 对象。

注意，传入无效 id 会导致未指定的行为。如果 source 为 null ，则此方法抛出 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

返回：

标识事件及其属性的字符串