模块  java.desktop
软件包  java.awt.event

Class 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

    • 字段详细信息

      • 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
        结果
        标识事件及其属性的字符串