Класс 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

Модификатор и тип	Поле	Описание
`protected Object`	`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`	`getSource()`	Объект, в котором первоначально произошло событие.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения для этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.

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

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.