- 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.event.ComponentEvent
getComponent
-
Methods inherited from class java.util.EventObject
getSource
-
-
-
-
字段详细信息
-
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
- 结果
- 标识事件及其属性的字符串
-
-