Module  java.desktop
软件包  java.beans

Class PropertyChangeEvent

  • All Implemented Interfaces:
    Serializable
    已知直接子类：
    IndexedPropertyChangeEvent 

    public class PropertyChangeEvent
extends EventObject
    只要bean更改“bound”或“constrained”属性，就会传递一个“PropertyChange”事件。 PropertyChangeEvent对象作为参数发送到PropertyChangeListener和VetoableChangeListener方法。

    通常PropertyChangeEvents将附带更改属性的名称和旧值和新值。 如果新值是一个基本类型（如int或boolean），那么它必须被包装为相应的java.lang。*对象类型（如Integer或Boolean）。

    如果旧值和新值未知，它们的真值可能会被提供。

    事件源可以发送一个空对象作为名称，以指示如果其属性已经更改的任意集合。 在这种情况下，旧值和新值也应为null。

    从以下版本开始：
    1.1
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • PropertyChangeEvent

        public PropertyChangeEvent​(Object source,
                           String propertyName,
                           Object oldValue,
                           Object newValue)
        构造新的 PropertyChangeEvent 。
        参数
        source - 触发事件的bean
        propertyName - 已更改的属性的编程名称
        oldValue - 该物业的旧值
        newValue - 物业的新价值
        异常
        IllegalArgumentException - 如果 source是 null

    • 方法详细信息

      • getPropertyName

        public String getPropertyName​()
        获取已更改的属性的编程名称。
        结果
        已更改的属性的编程名称。 如果多个属性已更改，则可以为null。

      • getNewValue

        public Object getNewValue​()
        获取属性的新值，表示为Object。
        结果
        属性的新值，表示为对象。 如果多个属性已更改，则可以为null。

      • getOldValue

        public Object getOldValue​()
        获取属性的旧值，表示为对象。
        结果
        该属性的旧值表示为Object。 如果多个属性已更改，则可以为null。

      • setPropagationId

        public void setPropagationId​(Object propagationId)
        设置事件的propagationId对象。
        参数
        propagationId - 事件的propagationId对象。

      • getPropagationId

        public Object getPropagationId​()
        “propagationId”字段保留供将来使用。 在Beans 1.0中，唯一的要求是如果一个监听器捕获一个PropertyChangeEvent，然后触发一个PropertyChangeEvent，那么它应该确保它将传播信号从传入事件传播到它的传出事件。
        结果
        与绑定/约束属性更新关联的propagationId对象。

      • toString

        public String toString​()
        返回对象的字符串表示形式。
        重写：
        toString在 EventObject
        结果
        对象的字符串表示形式
        从以下版本开始：
        1.7