Module java.desktop

软件包 java.awt.event

Class ContainerEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.ComponentEvent

java.awt.event.ContainerEvent

All Implemented Interfaces:

Serializable

public class ContainerEvent
extends ComponentEvent

低级别事件，表示容器的内容因添加或删除组件而发生更改。

集装箱事件仅供通报用途; AWT将自动处理内部对容器内容的更改，以使程序正常工作，而不管程序是否接收到这些事件。

当组件被添加到该组件或从其中删除时，此低级事件由容器对象（例如Panel）生成。 该事件传递给每个ContainerListener或ContainerAdapter对象，该对象使用组件的addContainerListener方法注册接收此类事件。 （ ContainerAdapter对象实现ContainerListener接口）每个这样的侦听器对象在事件发生时得到这个ContainerEvent 。

任何特定ContainerEvent实例的id参数不在CONTAINER_FIRST至CONTAINER_LAST的范围内，将会引起未指定的行为。

从以下版本开始：

1.1

另请参见：

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

Field Summary

Fields

Modifier and Type	Field	描述
static int	COMPONENT_ADDED	此事件表示组件已添加到容器中。
static int	COMPONENT_REMOVED	此事件表示组件已从容器中删除。
static int	CONTAINER_FIRST	用于容器事件的ids范围中的第一个数字。
static int	CONTAINER_LAST	用于容器事件的ids范围中的最后一个数字。

Fields inherited from class 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

Fields inherited from class java.awt.event.ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor	描述
ContainerEvent(Component source, int id, Component child)	构造一个 ContainerEvent对象。

方法摘要

Modifier and Type	方法	描述
Component	getChild()	返回受事件影响的组件。
Container	getContainer()	返回事件的发起者。
String	paramString()	返回标识此事件的参数字符串。

Methods inherited from class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods inherited from class java.awt.event.ComponentEvent

getComponent

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

CONTAINER_FIRST

public static final int CONTAINER_FIRST

用于容器事件的ids范围中的第一个数字。

另请参见：

Constant Field Values

CONTAINER_LAST

public static final int CONTAINER_LAST

用于容器事件的ids范围中的最后一个数字。

另请参见：

Constant Field Values

COMPONENT_ADDED

public static final int COMPONENT_ADDED

此事件表示组件已添加到容器中。

另请参见：

Constant Field Values

COMPONENT_REMOVED

public static final int COMPONENT_REMOVED

此事件表示组件已从容器中删除。

另请参见：

Constant Field Values

构造方法详细信息

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()

返回受事件影响的组件。

结果

添加或删除的组件对象

paramString

public String paramString()

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

重写：

paramString在 ComponentEvent

结果

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