java.beans

クラス PropertyChangeEvent

java.lang.Object

java.util.EventObject

java.beans.PropertyChangeEvent

すべての実装されたインタフェース:

Serializable

直系の既知のサブクラス:

IndexedPropertyChangeEvent

public class PropertyChangeEvent
extends EventObject

PropertyChange イベントは、Bean が「バウンド」プロパティーまたは「制約」プロパティーを変更するたびに送信されます。PropertyChangeEvent オブジェクトは、引数として PropertyChangeListener と VetoableChangeListener メソッドに送信されます。

通常、PropertyChangeEvents は、変更されたプロパティーの名前と変更前後の値とともに使用されます。新しい値がプリミティブ型 (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 オブジェクトを設定します。
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 - プロパティーの新しい値。

メソッドの詳細

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