Module java.desktop

Package 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范围内，将导致未指定的行为。

自 JDK 版本:

1.1

参见:

• ContainerAdapter
• ContainerListener
• 教程: 编写容器监听器
• 序列化形式

Field Summary

Fields

Modifier and Type	Field	Description
static final int	COMPONENT_ADDED	此事件指示向容器添加了一个组件。
static final int	COMPONENT_REMOVED	此事件指示从容器中移除了一个组件。
static final int	CONTAINER_FIRST	用于容器事件的 id 范围中的第一个数字。
static final int	CONTAINER_LAST	用于容器事件的 id 范围中的最后一个数字。

Fields declared in class java.awt.event.ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Fields declared in 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 declared in class java.util.EventObject

source

Constructor Summary

Constructors

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

Method Summary

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

Methods declared in class java.awt.event.ComponentEvent

getComponent

Methods declared in class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods declared in class java.util.EventObject

getSource

Methods declared in class java.lang.Object

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

Field Details

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
            

此事件指示从容器中移除了一个组件。

参见:

• 常量字段值

Constructor Details

ContainerEvent

             public ContainerEvent(Component source, int id, Component child)
            

构造一个ContainerEvent对象。

如果source为null，此方法将抛出IllegalArgumentException异常。

参数:

source - 产生事件的Component对象（容器）

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

child - 被添加或移除的组件

抛出:

IllegalArgumentException - 如果source为null

参见:

• getContainer()
• AWTEvent.getID()
• getChild()

Method Details

getContainer

             public Container getContainer()
            

返回事件的发起者。

返回:

产生事件的Container对象，如果对象不是Container，则返回null。

getChild

             public Component getChild()
            

返回受事件影响的组件。

返回:

被添加或移除的Component对象

paramString

             public String paramString()
            

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

覆盖:

paramString 在类 ComponentEvent

返回:

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