模块  java.desktop
软件包  java.beans

Class PropertyChangeEvent

  • 实现的所有接口
    Serializable
    已知直接子类：
    IndexedPropertyChangeEvent 
    public class PropertyChangeEventextends EventObject
    每当bean更改“绑定”或“约束”属性时，都会传递“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。
        结果
        属性的新值，表示为Object。 如果多个属性已更改，则可以为null。

      • getOldValue

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

      • setPropagationId

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

      • getPropagationId

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

      • toString

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