Класс PropertyChangeEvent

public class PropertyChangeEvent
extends EventObject

Событие "PropertyChange" доставляется всякий раз, когда компонент изменяет "связанное" или "ограниченное" свойство. Объект PropertyChangeEvent передаётся в качестве аргумента методам PropertyChangeListener и VetoableChangeListener.

Обычно PropertyChangeEvents сопровождаются именем и старым и новым значением изменённого свойства. Если новое значение — примитивный тип (например, int или boolean), оно должно быть обернуто как соответствующий тип объекта java.lang.* (например, Integer или Boolean).

Могут предоставляться нулевые значения для старых и новых значений, если их истинные значения неизвестны.

Источник события может отправить нулевой объект в качестве имени, чтобы указать, что изменился произвольный набор его свойств. В этом случае старые и новые значения также должны быть нулевыми.

Конструкторы

PropertyChangeEvent

public PropertyChangeEvent(Object source,
                           String propertyName,
                           Object oldValue,
                           Object newValue)

Создаёт новый PropertyChangeEvent.

Параметры:

source - компонент, сгенерировавший событие

propertyName - программное имя свойства, которое было изменено

oldValue - старое значение свойства

newValue - новое значение свойства

Исключения:

IllegalArgumentException - если source равно null

Методы

getPropertyName

public String getPropertyName()

Возвращает программное имя свойства, которое было изменено.

Возвращает:

Программное имя свойства, которое было изменено. Может быть null, если изменилось несколько свойств.

getNewValue

public Object getNewValue()

Возвращает новое значение свойства, выраженное как объект.

Возвращает:

Новое значение свойства, выраженное как объект. Может быть null, если изменилось несколько свойств.

getOldValue

public Object getOldValue()

Возвращает старое значение свойства, выраженное как объект.

Возвращает:

Старое значение свойства, выраженное как объект. Может быть null, если изменилось несколько свойств.

setPropagationId

public void setPropagationId(Object propagationId)

Устанавливает объект propagationId для события.

Параметры:

propagationId - Объект propagationId для события.

getPropagationId

public Object getPropagationId()

Поле "propagationId" зарезервировано для будущего использования. В Beans 1.0 единственное требование заключается в том, что если слушатель перехватывает PropertyChangeEvent и затем генерирует свой собственный PropertyChangeEvent, то он должен убедиться, что передает поле propagationId из своего входного события в своё выходное событие.

Возвращает:

Объект propagationId, связанный с обновлением связанного/ограниченного свойства.

toString

public String toString()

Возвращает строковое представление объекта.

Переопределяет:

toString в классе EventObject

Возвращает:

строковое представление объекта

С тех пор, как:

1.7