模块  java.desktop
软件包  java.beans

Class PropertyChangeEvent

  • 实现的所有接口
    Serializable
    已知直接子类:
    IndexedPropertyChangeEvent

    public class PropertyChangeEvent
    extends 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 - 如果 sourcenull
    • 方法详细信息

      • 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