java.beans
クラス PropertyChangeSupport

java.lang.Object
  |
  +--java.beans.PropertyChangeSupport

直接の既知のサブクラス:

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