Класс PropertyChangeEvent

java.lang.Object
- java.util.EventObject
- - java.beans.PropertyChangeEvent

Все реализованные интерфейсы:: Serializable

Непосредственные известные подклассы:: IndexedPropertyChangeEvent

public class PropertyChangeEvent
extends EventObject

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

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

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

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

С момента:: 1.1
См. также:: Сериализованная форма

Поля

Поля, объявленные в классе java.util.EventObject

source

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

Конструктор	Описание
`PropertyChangeEvent(Object source, String propertyName, Object oldValue, Object newValue)`	Создаёт новый `PropertyChangeEvent`.

Методы

Модификатор и тип	Метод	Описание
`Object`	`getNewValue()`	Возвращает новое значение свойства в виде объекта.
`Object`	`getOldValue()`	Возвращает старое значение свойства в виде объекта.
`Object`	`getPropagationId()`	Поле «propagationId» зарезервировано для использования в будущем.
`String`	`getPropertyName()`	Возвращает программное имя свойства, которое было изменено.
`void`	`setPropagationId(Object propagationId)`	Устанавливает объект propagationId для события.
`String`	`toString()`	Возвращает строковое представление объекта.

Методы, объявленные в классе java.util.EventObject

getSource

Методы, объявленные в классе java.lang.Object

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

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

PropertyChangeEvent

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

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

Параметры:: source - компонент, сгенерировавший событие; propertyName - программное имя свойства, которое было изменено; oldValue - старое значение свойства; newValue - новое значение свойства
Исключения:: IllegalArgumentException - если source имеет значение null

Методы

getPropertyName

public String getPropertyName()

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

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

getNewValue

public Object getNewValue()

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

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

getOldValue

public Object getOldValue()

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

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

setPropagationId

public void setPropagationId(Object propagationId)

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

Параметры:: propagationId - Объект propagationId для события.

getPropagationId

public Object getPropagationId()

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

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

toString

public String toString()

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

Переопределяет:: toString в классе EventObject
Возвращает:: Строковое представление объекта
С момента:: 1.7