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 オブジェクトを設定します。

クラス 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 フィールドを受信イベントから送信イベントに確実に伝達することが唯一の要件となります。

戻り値:

バウンドプロパティーまたは制約プロパティーの更新に関連した propagationId オブジェクト