JavaTM Platform
Standard Ed. 6

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 オブジェクト

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。