JavaTM Platform
Standard Ed. 6

java.beans
类 PropertyChangeEvent

java.lang.Object
  继承者 java.util.EventObject
      继承者 java.beans.PropertyChangeEvent
所有已实现的接口:
Serializable
直接已知子类:
IndexedPropertyChangeEvent

public class PropertyChangeEvent
     
extends EventObject

无论 bean 何时更改 "bound" 或 "constrained" 属性,都会提交一个 "PropertyChange" 事件。PropertyChangeEvent 对象被作为参数发送给 PropertyChangeListener 和 VetoableChangeListener 方法。

通常 PropertyChangeEvent 还附带名称和已更改属性的旧值和新值。如果新值是基本类型(比如 int 或 boolean),则必须将它包装为相应的 java.lang.* Object 类型(比如 Integer 或 Boolean)。

如果旧值和新值的真实值是未知的,则可能为它们提供 null 值。

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

另请参见:
序列化表格

字段摘要
 
从类 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 对象。
 
从类 java.util.EventObject 继承的方法
getSource, toString
 
从类 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 - 属性的新值。
方法详细信息

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 字段从其传入事件传播到其传出事件。

返回:
与绑定/约束 (bound/constrained) 属性更新关联的 propagationId 对象。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策