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

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

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