|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.beans.PropertyChangeSupport
public class PropertyChangeSupport
バウンドプロパティをサポートする bean で使用できるユーティリティクラスです。このクラスのインスタンスを bean のメンバフィールドとして使用し、さまざまな処理を委譲することができます。 このクラスは直列化可能です。直列化した場合、このクラスは直列化可能な任意のリスナーを保存 (および復元) します。直列化可能でないリスナーは、直列化の際にスキップされます。
コンストラクタの概要 | |
---|---|
PropertyChangeSupport(Object sourceBean)
PropertyChangeSupport オブジェクトを構築します。 |
メソッドの概要 | |
---|---|
void |
addPropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener をリスナーリストに追加します。 |
void |
addPropertyChangeListener(String propertyName,
PropertyChangeListener listener)
特定のプロパティの PropertyChangeListener を追加します。 |
void |
fireIndexedPropertyChange(String propertyName,
int index,
boolean oldValue,
boolean newValue)
登録されているリスナーに、 boolean バウンドインデックス付きプロパティの更新を通知します。 |
void |
fireIndexedPropertyChange(String propertyName,
int index,
int oldValue,
int newValue)
登録されているリスナーに、 int バウンドインデックス付きプロパティの更新を通知します。 |
void |
fireIndexedPropertyChange(String propertyName,
int index,
Object oldValue,
Object newValue)
登録されているリスナーに、バウンドインデックス付きプロパティの更新を通知します。 |
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)
登録されているリスナーに、バウンドプロパティの更新を通知します。 |
PropertyChangeListener[] |
getPropertyChangeListeners()
addPropertyChangeListener() によって PropertyChangeSupport オブジェクトに追加されたすべてのリスナーの配列を返します。 |
PropertyChangeListener[] |
getPropertyChangeListeners(String propertyName)
指定されたプロパティに関連付けられたすべてのリスナーの配列を返します。 |
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 |
コンストラクタの詳細 |
---|
public PropertyChangeSupport(Object sourceBean)
PropertyChangeSupport
オブジェクトを構築します。
sourceBean
- すべてのイベントのソースとして指定される beanメソッドの詳細 |
---|
public void addPropertyChangeListener(PropertyChangeListener listener)
listener
が null の場合、例外はスローされず、何も処理は行われません。
listener
- 追加する PropertyChangeListenerpublic void removePropertyChangeListener(PropertyChangeListener listener)
listener
が同じイベントソースに対して複数回追加された場合は、削除されたあとに 1 回分少なく通知されます。listener
が null の場合、または一度も追加されなかった場合は、例外はスローされず、何も処理は行われません。
listener
- 削除する PropertyChangeListenerpublic PropertyChangeListener[] getPropertyChangeListeners()
指定されたプロパティによって追加されたリスナーがある場合、PropertyChangeListener と PropertyChangeListenerProxy
からなる配列が返されます。リスナーの識別に関係している呼び出し元メソッドは、個々の要素をテストして PropertyChangeListenerProxy
であるかどうかの確認、キャスト、パラメータの確認を行う必要があります。
PropertyChangeListener[] listeners = bean.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" } } }
PropertyChangeListeners
。リスナーが追加されていない場合は空の配列PropertyChangeListenerProxy
public void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
propertyName
または listener
が null の場合は、例外はスローされず、何も処理は行われません。
propertyName
- 待機しているプロパティの名前listener
- 追加する PropertyChangeListenerpublic void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
listener
が指定のプロパティの同じイベントソースに対して複数回追加された場合は、削除されたあとに 1 回分少なく通知されます。propertyName
が null の場合は、例外はスローされず、何も処理は行われません。listener
が null の場合、または指定のプロパティに対して一度も追加されなかった場合は、例外はスローされず、何も処理は行われません。
propertyName
- 待機していたプロパティの名前listener
- 削除する PropertyChangeListenerpublic PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
propertyName
- 待機しているプロパティ名
PropertyChangeListeners
。このようなリスナーが追加されていない場合、または propertyName
が null の場合は空の配列が返されるpublic void firePropertyChange(String propertyName, Object oldValue, Object newValue)
propertyName
- 変更されたプロパティのプログラム上の名前oldValue
- プロパティの古い値newValue
- プロパティの新しい値public void firePropertyChange(String propertyName, int oldValue, int newValue)
このメソッドは、Object 値をとる、より一般的な firePropertyChange メソッドの簡易ラッパーです。
propertyName
- 変更されたプロパティのプログラム上の名前oldValue
- プロパティの古い値newValue
- プロパティの新しい値public void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
このメソッドは、Object 値をとる、より一般的な firePropertyChange メソッドの簡易ラッパーです。
propertyName
- 変更されたプロパティのプログラム上の名前oldValue
- プロパティの古い値newValue
- プロパティの新しい値public void firePropertyChange(PropertyChangeEvent evt)
evt
- PropertyChangeEvent オブジェクトpublic void fireIndexedPropertyChange(String propertyName, int index, Object oldValue, Object newValue)
古い値と新しい値が等しく、null でない場合、イベントはトリガされません。
propertyName
- 変更されたプロパティのプログラム上の名前index
- 変更されたプロパティ要素のインデックスoldValue
- プロパティの古い値newValue
- プロパティの新しい値public void fireIndexedPropertyChange(String propertyName, int index, int oldValue, int newValue)
int
バウンドインデックス付きプロパティの更新を通知します。
古い値と新しい値が等しく、null でない場合、イベントはトリガされません。
このメソッドは、Object 値をとる、より一般的な fireIndexedPropertyChange メソッドの簡易ラッパーです。
propertyName
- 変更されたプロパティのプログラム上の名前index
- 変更されたプロパティ要素のインデックスoldValue
- プロパティの古い値newValue
- プロパティの新しい値public void fireIndexedPropertyChange(String propertyName, int index, boolean oldValue, boolean newValue)
boolean
バウンドインデックス付きプロパティの更新を通知します。
古い値と新しい値が等しく、null でない場合、イベントはトリガされません。
このメソッドは、Object 値をとる、より一般的な fireIndexedPropertyChange メソッドの簡易ラッパーです。
propertyName
- 変更されたプロパティのプログラム上の名前index
- 変更されたプロパティ要素のインデックスoldValue
- プロパティの古い値newValue
- プロパティの新しい値public boolean hasListeners(String propertyName)
propertyName
が null の場合は、すべてのプロパティに登録されたリスナーのみを確認します。
propertyName
- プロパティ名
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。