java.beans

Class PropertyChangeEvent

java.lang.Object

java.util.EventObject

java.beans.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。

另请参见：

Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
PropertyChangeEvent(Object source, String propertyName, Object oldValue, Object newValue) 构造一个新的 PropertyChangeEvent 。

方法摘要

Modifier and Type	Method and Description
Object	getNewValue() 获取属性的新值，表示为Object。
Object	getOldValue() 获取属性的旧值，表示为对象。
Object	getPropagationId() “propagationId”字段保留供将来使用。
String	getPropertyName() 获取已更改的属性的编程名称。
void	setPropagationId(Object propagationId) 设置事件的propagationId对象。
String	toString() 返回对象的字符串表示形式。

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

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