Класс 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 в качестве имени, чтобы указать, что изменился произвольный набор его свойств. В этом случае старое и новое значения также должны быть 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" зарезервировано для использования в будущем. В Bean 1.0 единственным требованием является то, что если слушатель поймает PropertyChangeEvent и затем сгенерирует PropertyChangeEvent, то он должен убедиться, что он распространяет поле propagationId от входящего события к исходящему.

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

toString

public String toString()

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

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

© 1993, 2023, 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/21/docs/api/java.desktop/java/beans/PropertyChangeEvent.html