Класс PropertyChangeEvent

java.lang.Object

java.util.EventObject

java.beans.PropertyChangeEvent

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

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

public class PropertyChangeEvent extends EventObject

Событие «PropertyChange» возникает при каждом изменении bean-компонентом привязанного или ограниченного свойства. Объект PropertyChangeEvent передается в качестве аргумента методам PropertyChangeListener и VetoableChangeListener.

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

Для старого и нового значений можно указать null, если их фактические значения неизвестны.

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

Начиная с:

1.1

См. также:

Краткое описание полей

Поля, объявленные в классе 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()`	Возвращает строковое представление объекта.

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

getSource

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

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

Подробное описание конструкторов

PropertyChangeEvent

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

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

Параметры:: source — bean-компонент, вызвавший событие; 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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/beans/PropertyChangeEvent.html