模块 java.desktop
包 java.beans

类 PropertyChangeEvent

java.lang.Object
java.util.EventObject
java.beans.PropertyChangeEvent
所有已实现的接口：
Serializable
已知子类：
IndexedPropertyChangeEvent
public class PropertyChangeEvent extends EventObject
每当 bean 更改“绑定”或“约束”属性时，都会传递“PropertyChange”事件。 PropertyChangeEvent 对象作为参数发送给 PropertyChangeListener 和 VetoableChangeListener 方法。

通常，PropertyChangeEvents 伴随着已更改属性的名称以及旧值和新值。如果新值是原始类型（例如 int 或 boolean），则必须将其包装为相应的 java.lang.* 对象类型（例如 Integer 或 Boolean）。

如果不知道它们的真实值，则可以为旧值和新值提供空值。

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

自从：
1.1
参见：

  • 构造方法详细信息

    • 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()
      获取属性的旧值，表示为对象。
      返回：
      属性的旧值，表示为对象。如果多个属性已更改，则可能为 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