Класс PropertyChangeEvent

java.lang.Object

java.util.EventObject

java.beans.PropertyChangeEvent

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

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

public class PropertyChangeEvent extends EventObject

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

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

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

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

С момента:

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()

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

Возвращает:: Программное имя изменённого свойства. Может быть 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/beans/PropertyChangeEvent.html