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 物件。