Module  java.desktop
软件包  java.awt.event

Class ContainerEvent

  • All Implemented Interfaces:
    Serializable


    public class ContainerEvent
    extends ComponentEvent
    低级别事件,表示容器的内容因添加或删除组件而发生更改。

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

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

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

    从以下版本开始:
    1.1
    另请参见:
    ContainerAdapterContainerListenerTutorial: Writing a Container ListenerSerialized Form
    • 字段详细信息

      • 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如果sourcenull

        参数
        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​()
        返回标识此事件的参数字符串。 此方法对于事件记录和调试很有用。
        重写:
        paramStringComponentEvent
        结果
        标识事件及其属性的字符串