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
extends ComponentEvent

指示容器内容因为添加或移除组件而更改的低级别事件。

这些容器事件“仅”为通知目的而提供；AWT 将自动处理内部容器内容的更改，使程序正常工作，而不管该程序是否接收这些事件。

在向容器对象（比如 Panel）添加组件或从中移除组件时，容器对象将生成此低级别事件。事件被传递给每一个 ContainerListener 或 ContainerAdapter 对象，这些对象使用组件的 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 会导致未指定的行为。如果 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

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

java.awt.event

接口

类

java.awt.event 类 ContainerEvent