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 など) としてラップする必要があります。

古い値と新しい値の true の値が未知の場合、両方の値に対して null が返されます。

イベントソースは、そのプロパティのうち任意のセットが変更されたことを示すため、名前として null オブジェクトを送信できます。この場合、古い値と新しい値はどちらも null になります。

関連項目:

直列化された形式

フィールドの概要

クラス java.util.EventObject から継承されたフィールド

source

コンストラクタの概要

PropertyChangeEvent(Object source, String propertyName, Object oldValue, Object newValue)
新しい PropertyChangeEvent を構築します。

メソッドの概要

Object	getNewValue() プロパティに新しい値を設定します。
Object	getOldValue() プロパティの古い値を取得します。
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 オブジェクト