javax.swing.event
クラス SwingPropertyChangeSupport

java.lang.Object
  |
  +--java.beans.PropertyChangeSupport
        |
        +--javax.swing.event.SwingPropertyChangeSupport

すべての実装インタフェース:

Serializable

public final class SwingPropertyChangeSupport

extends PropertyChangeSupport

このサブクラスは java.beans.PropertyChangeSupport と機能的には同じです。Swing では重要でないスレッドに対する安全性を犠牲にする代わりに、メモリの消費を少なくし、パフォーマンスを改善します。これらは Swing で非常に重要です。オーバーライドされたメソッドのほとんどは、すべての PropertyChangeSupport のインスタンスデータが private で、アクセス用メソッドがないために必要となるだけです。

コンストラクタの概要

SwingPropertyChangeSupport(Object sourceBean)
SwingPropertyChangeSupport オブジェクトを構築します。

メソッドの概要

void	addPropertyChangeListener(PropertyChangeListener listener) PropertyChangeListener をリスナーリストに追加します。
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener) 特定のプロパティの PropertyChangeListener を追加します。
void	firePropertyChange(PropertyChangeEvent evt) 登録されているリスナーに、既存の PropertyChangeEvent をトリガします。
void	firePropertyChange(String propertyName, Object oldValue, Object newValue) 登録されているリスナーに、バウンドプロパティの更新を通知します。
PropertyChangeListener[]	getPropertyChangeListeners() addPropertyChangeListener() を使用して SwingPropertyChangeSupport に追加されたすべてのリスナーの配列を返します。
PropertyChangeListener[]	getPropertyChangeListeners(String propertyName) 指定したプロパティに関連付けられたすべてのリスナーの配列を返します。
boolean	hasListeners(String propertyName) 特定のプロパティにリスナーがあるかどうかを判定します。
void	removePropertyChangeListener(PropertyChangeListener listener) PropertyChangeListener をリスナーリストから削除します。
void	removePropertyChangeListener(String propertyName, PropertyChangeListener listener) 特定のプロパティの PropertyChangeListener を削除します。

クラス java.beans.PropertyChangeSupport から継承したメソッド

firePropertyChange, firePropertyChange

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

SwingPropertyChangeSupport

public SwingPropertyChangeSupport(Object sourceBean)

SwingPropertyChangeSupport オブジェクトを構築します。

パラメータ:

sourceBean - すべてのイベントのソースとして指定される bean

メソッドの詳細

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

PropertyChangeListener をリスナーリストに追加します。リスナーは、すべてのプロパティで登録されます。

オーバーライド:

クラス PropertyChangeSupport 内の addPropertyChangeListener

パラメータ:

listener - 追加する PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

PropertyChangeListener をリスナーリストから削除します。これは、すべてのプロパティで登録された PropertyChangeListener を削除します。

オーバーライド:

クラス PropertyChangeSupport 内の removePropertyChangeListener

パラメータ:

listener - 削除する PropertyChangeListener

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

addPropertyChangeListener() を使用して SwingPropertyChangeSupport に追加されたすべてのリスナーの配列を返します。

指定されたプロパティで一部のリスナーが追加された場合、返される配列は PropertyChangeListeners と PropertyChangeListenerProxy の混合となります。呼び出しメソッドがリスナーの識別に関心を持つ場合は、各要素を判定して、そのリスナーがPropertyChangeListenerProxy であるかどうかを識別し、パラメータをキャストして調べる必要があります。

 PropertyChangeListener[] listeners = support.getPropertyChangeListeners();
 for (int i = 0; i < listeners.length; i++) {
	 if (listeners[i] instanceof PropertyChangeListenerProxy) {
     PropertyChangeListenerProxy proxy = 
                    (PropertyChangeListenerProxy)listeners[i];
     if (proxy.getPropertyName().equals("foo")) {
       // proxy is a PropertyChangeListener which was associated
       // with the property named "foo"
     }
   }
 }

オーバーライド:

クラス PropertyChangeSupport 内の getPropertyChangeListeners

戻り値:

追加されたすべての PropertyChangeListener、またはリスナーが追加されなかった場合は空の配列

導入されたバージョン:

1.4

関連項目:

PropertyChangeListenerProxy, PropertyChangeSupport.getPropertyChangeListeners()

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener listener)

特定のプロパティの PropertyChangeListener を追加します。リスナーが呼び出されるのは、firePropertyChange の呼び出しにより、その特定のプロパティが指定されたときだけです。

オーバーライド:

クラス PropertyChangeSupport 内の addPropertyChangeListener

パラメータ:

propertyName - 待機しているプロパティの名前

listener - 追加する PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName,
                                         PropertyChangeListener listener)

特定のプロパティの PropertyChangeListener を削除します。

オーバーライド:

クラス PropertyChangeSupport 内の removePropertyChangeListener

パラメータ:

propertyName - 待機していたプロパティの名前

listener - 削除する PropertyChangeListener

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

指定したプロパティに関連付けられたすべてのリスナーの配列を返します。

オーバーライド:

クラス PropertyChangeSupport 内の getPropertyChangeListeners

戻り値:

指定したプロパティに関連付けられたすべての PropertyChangeListeners、またはリスナーが追加されなかった場合は空の配列

firePropertyChange

public void firePropertyChange(String propertyName,
                               Object oldValue,
                               Object newValue)

登録されているリスナーに、バウンドプロパティの更新を通知します。以前の値と新しい値が等しくて null でない場合、イベントはトリガされません。

オーバーライド:

クラス PropertyChangeSupport 内の firePropertyChange

パラメータ:

propertyName - 変更されたプロパティのプログラム上の名前

oldValue - プロパティの古い値

newValue - プロパティの新しい値

firePropertyChange

public void firePropertyChange(PropertyChangeEvent evt)

登録されているリスナーに、既存の PropertyChangeEvent をトリガします。指定されたイベントの以前の値と新しい値が等しくて null でない場合、イベントはトリガされません。

オーバーライド:

クラス PropertyChangeSupport 内の firePropertyChange

パラメータ:

evt - PropertyChangeEvent オブジェクト

hasListeners

public boolean hasListeners(String propertyName)

特定のプロパティにリスナーがあるかどうかを判定します。

オーバーライド:

クラス PropertyChangeSupport 内の hasListeners

パラメータ:

propertyName - プロパティ名

戻り値:

指定したプロパティに 1 つ以上のリスナーがある場合は true