java.beans
クラス PropertyChangeEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--java.beans.PropertyChangeEvent

public class PropertyChangeEvent

extends EventObject

PropertyChange イベントは、bean が「バウンド」プロパティまたは「制約」プロパティを変更するたびに発生します。PropertyChangeEvent オブジェクトは、引数として PropertyChangeListener および VetoableChangeListenerobject メソッドに送られます。

通常 PropertyChangeEvent は、変更したプロパティの名前と新しい値を持ちます。新しい値が組み込み型 (int や boolean など) の場合は、対応する java.lang.* オブジェクト型 (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 オブジェクト