Module java.desktop
Package java.beans

Class 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）。

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

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

自 JDK 版本:
1.1
另请参阅:

  • Constructor Details

    • PropertyChangeEvent

      public PropertyChangeEvent(Object source, String propertyName, Object oldValue, Object newValue)
      构造一个新的 PropertyChangeEvent。
      参数:
      source - 触发事件的 bean
      propertyName - 已更改属性的程序化名称
      oldValue - 属性的旧值
      newValue - 属性的新值
      抛出:
      IllegalArgumentException - 如果 source 是 null

  • Method Details

    • 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
      返回:
      对象的字符串表示形式
      自 JDK 版本:
      1.7