模块 java.desktop

软件包 java.awt.event

Class 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）或从组件对象中删除时，会生成此低级事件。 该事件将传递给每个注册为使用组件的addContainerListener方法接收此类事件的ContainerListener或ContainerAdapter对象。 （ ContainerAdapter对象实现ContainerListener接口。）每个此类侦听器对象在事件发生时获取此ContainerEvent 。

如果任何特定ContainerEvent实例的id参数不在CONTAINER_FIRST到CONTAINER_LAST的范围内， CONTAINER_FIRST导致未指定的行为。

从以下版本开始：

1.1

另请参见：

ContainerAdapter ， ContainerListener ， Tutorial: Writing a Container Listener ， Serialized Form

字段汇总

字段

变量和类型	字段	描述
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对象。

此方法抛出IllegalArgumentException如果source为null 。

参数

source - 发起事件的 Component对象（容器）

id - 指示事件类型的整数。 有关允许值的信息，请参阅ContainerEvent的类说明

child - 已添加或删除的组件

异常

IllegalArgumentException - 如果 source为空

另请参见：

getContainer() ， AWTEvent.getID() ， getChild()

方法详细信息

getContainer

public Container getContainer()

返回事件的发起者。

结果

所述 Container对象发起事件，或 null如果对象不是 Container 。

getChild

public Component getChild()

返回受事件影响的组件。

结果

添加或删除的Component对象

paramString

public String paramString()

返回标识此事件的参数字符串。 此方法对于事件记录和调试很有用。

重写：

paramString在课程 ComponentEvent

结果

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