模块 java.desktop

软件包 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。

从以下版本开始：

1.1

另请参见：

Serialized Form

字段汇总

声明的属性在类 java.util.EventObject

source

构造方法摘要

构造方法

构造器	描述
PropertyChangeEvent(Object source, String propertyName, Object oldValue, Object newValue)	构造一个新的 PropertyChangeEvent 。

方法摘要

变量和类型	方法	描述
Object	getNewValue()	获取属性的新值，表示为Object。
Object	getOldValue()	获取属性的旧值，表示为Object。
Object	getPropagationId()	“propagationId”字段保留供将来使用。
String	getPropertyName()	获取已更改的属性的编程名称。
void	setPropagationId(Object propagationId)	设置事件的propagationId对象。
String	toString()	返回对象的字符串表示形式。

声明方法的类 java.util.EventObject

getSource

声明方法的类 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。

结果

属性的新值，表示为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