JavaTM 2 Platform
Std. Ed. v1.3

java.beans
クラス PropertyChangeSupport

java.lang.Object
  |
  +--java.beans.PropertyChangeSupport
すべての実装インタフェース:
Serializable
直系の既知のサブクラス:
SwingPropertyChangeSupport

public class PropertyChangeSupport
extends Object
implements Serializable

バウンドプロパティをサポートする bean で使用できるユーティリティクラスです。このクラスのインスタンスを bean のメンバフィールドとして使用し、さまざまな処理を委譲することができます。 このクラスは直列化可能です。直列化した場合、このクラスは直列化可能な任意のリスナーを保存 (および復元) します。直列化可能でないリスナーは、直列化の際にスキップされます。

関連項目:
直列化された形式

コンストラクタの概要
PropertyChangeSupport(Object sourceBean)
          PropertyChangeSupport オブジェクトを構築します。
 
メソッドの概要
 void addPropertyChangeListener(PropertyChangeListener listener)
          PropertyChangeListener をリスナーリストに追加します。
 void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
          特定のプロパティの PropertyChangeListener を追加します。
 void firePropertyChange(PropertyChangeEvent evt)
          登録されているリスナーに、既存の PropertyChangeEvent をトリガーします。
 void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
          登録されているすべてのリスナーに boolean バウンドプロパティの更新を通知します。
 void firePropertyChange(String propertyName, int oldValue, int newValue)
          登録されているすべてのリスナーに int バウンドプロパティの更新を通知します。
 void firePropertyChange(String propertyName, Object oldValue, Object newValue)
          登録されているリスナーに、バウンドプロパティの更新を通知します。
 boolean hasListeners(String propertyName)
          特定のプロパティにリスナーがあるかどうかを判定します。
 void removePropertyChangeListener(PropertyChangeListener listener)
          PropertyChangeListener をリスナーリストから削除します。
 void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
          特定のプロパティの PropertyChangeListener を削除します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

PropertyChangeSupport

public PropertyChangeSupport(Object sourceBean)
PropertyChangeSupport オブジェクトを構築します。
パラメータ:
sourceBean - すべてのイベントのソースとして指定される bean
メソッドの詳細

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストに追加します。リスナーは、すべてのプロパティで登録されます。
パラメータ:
listener - 追加する PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストから削除します。これは、すべてのプロパティで登録された PropertyChangeListener を削除します。
パラメータ:
listener - 削除する PropertyChangeListener

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)
特定のプロパティの PropertyChangeListener を追加します。リスナーが呼び出されるのは、firePropertyChange の呼び出しにより、その特定のプロパティが指定されたときだけです。
パラメータ:
propertyName - 待機しているプロパティの名前
listener - 追加する PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName,
                                         PropertyChangeListener listener)
特定のプロパティの PropertyChangeListener を削除します。
パラメータ:
propertyName - 待機していたプロパティの名前
listener - 削除する PropertyChangeListener

firePropertyChange

public void firePropertyChange(String propertyName,
                               Object oldValue,
                               Object newValue)
登録されているリスナーに、バウンドプロパティの更新を通知します。以前の値と新しい値が等しくて null でない場合、イベントはトリガーされません。
パラメータ:
propertyName - 変更されたプロパティのプログラム上の名前
oldValue - プロパティの古い値
newValue - プロパティの新しい値

firePropertyChange

public void firePropertyChange(String propertyName,
                               int oldValue,
                               int newValue)
登録されているすべてのリスナーに int バウンドプロパティの更新を通知します。古い値と新しい値が等しくて null でない場合、イベントはトリガーされません。

このメソッドは、Object 値をとる、より一般的な firePropertyChange メソッドの簡易ラッパーです。

パラメータ:
propertyName - 変更されたプロパティのプログラム上の名前
oldValue - プロパティの古い値
newValue - プロパティの新しい値

firePropertyChange

public void firePropertyChange(String propertyName,
                               boolean oldValue,
                               boolean newValue)
登録されているすべてのリスナーに boolean バウンドプロパティの更新を通知します。古い値と新しい値が等しくて null でない場合、イベントはトリガーされません。

このメソッドは、Object 値をとる、より一般的な firePropertyChange メソッドの簡易ラッパーです。

パラメータ:
propertyName - 変更されたプロパティのプログラム上の名前
oldValue - プロパティの古い値
newValue - プロパティの新しい値

firePropertyChange

public void firePropertyChange(PropertyChangeEvent evt)
登録されているリスナーに、既存の PropertyChangeEvent をトリガーします。指定されたイベントの以前の値と新しい値が等しくて null でない場合、イベントはトリガーされません。
パラメータ:
evt - PropertyChangeEvent オブジェクト

hasListeners

public boolean hasListeners(String propertyName)
特定のプロパティにリスナーがあるかどうかを判定します。
パラメータ:
propertyName - プロパティ名
戻り値:
指定したプロパティに 1 つ以上のリスナーがある場合は true

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.