Класс JavaBeanObjectProperty<T>
- javafx.beans.binding.ObjectExpression<T>
-
- javafx.beans.property.ReadOnlyObjectProperty<T>
-
- javafx.beans.property.ObjectProperty<T>
-
- javafx.beans.property.adapter.JavaBeanObjectProperty<T>
Все реализованные интерфейсы:
Observable, JavaBeanProperty<T>, ReadOnlyJavaBeanProperty<T>, Property<T>, ReadOnlyProperty<T>, ObservableObjectValue<T>, ObservableValue<T>, WritableObjectValue<T>, WritableValue<T>
public final class JavaBeanObjectProperty<T> extends ObjectProperty<T> implements JavaBeanProperty<T>
T и JavaFX свойством ObjectProperty<T>. Он не может быть создан напрямую, но должен быть создан с помощью JavaBeanObjectPropertyBuilder. В минимальном варианте JavaBean должен реализовывать геттер и сеттер для свойства. При вызове геттера экземпляра этого класса, возвращается свойство JavaBean. При вызове сеттера, значение передается свойству JavaBean. Если свойство JavaBean привязано (т.е. поддерживает PropertyChangeListeners), этот адаптер будет отслеживать изменения в JavaBean. В противном случае он может быть уведомлен об изменениях с помощью вызова fireValueChangedEvent(). Если свойство JavaBean также ограничено (т.е. поддерживает VetoableChangeListeners), этот адаптер отклонит изменения, если он привязан к ObservableValue<Object>.
С момента:
JavaFX 2.1
См. также:
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод и описание voidaddListener(ChangeListener<? super T> listener)ДобавляетChangeListener, который будет уведомляться всякий раз, когда значениеObservableValueизменяется.voidaddListener(InvalidationListener listener)ДобавляетInvalidationListener, который будет уведомляться всякий раз, когдаObservableстановится недействительным.voidbind(ObservableValue<? extends T> observable)Создаёт однонаправленную привязку для этогоProperty.voiddispose()Уведомляет JavaFX-свойство о том, что оно больше не будет использоваться, и любые ссылки могут быть удалены.voidfireValueChangedEvent()Этот метод можно вызвать, чтобы уведомить адаптер об изменении значения JavaBean, если свойство JavaBean не привязано (т.е.Tget()Получить обернутое значение.ObjectgetBean()ВозвращаетObject, содержащий это свойство.StringgetName()Возвращает имя этого свойства.booleanisBound()Можно использовать для проверки, еслиPropertyпривязан.voidremoveListener(ChangeListener<? super T> listener)Удаляет указанный слушатель из списка слушателей, которые уведомляются всякий раз, когда значениеObservableValueизменяется.voidremoveListener(InvalidationListener listener)Удаляет указанного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableстановится недействительным.voidset(T value)Установить обернутое значение.StringtoString()Возвращает строковое представление этого объектаJavaBeanObjectProperty.voidunbind()Удаляет однонаправленную привязку для этогоProperty.-
Методы, унаследованные от класса javafx.beans.property.ObjectProperty
bindBidirectional, setValue, unbindBidirectional
-
Методы, унаследованные от класса javafx.beans.binding.ObjectExpression
asString, asString, asString, getValue, isEqualTo, isEqualTo, isNotEqualTo, isNotEqualTo, isNotNull, isNull, objectExpression
-
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Методы, унаследованные от интерфейса javafx.beans.property.Property
bindBidirectional, unbindBidirectional
-
Методы, унаследованные от интерфейса javafx.beans.value.ObservableValue
getValue
-
Методы, унаследованные от интерфейса javafx.beans.value.WritableValue
getValue, setValue
-
-
Подробное описание методов
-
get
public T get()
Получите обернутое значение. Оно должно быть идентично значению, возвращаемому изWritableValue.getValue().Этот метод существует только для выравнивания API WritableObjectValue с
WritableBooleanValueи подклассамиWritableNumberValueУказано:
getв интерфейсеObservableObjectValue<T>Указано:
getв интерфейсеWritableObjectValue<T>Возвращает:
Текущее значение
Исключение:
UndeclaredThrowableException- если вызов геттера свойства Java Bean вызываетIllegalAccessExceptionилиInvocationTargetException.
-
set
public void set(T value)
Установите обернутое значение. Должно быть эквивалентноWritableValue.setValue(java.lang.Object)Указано:
setв интерфейсеWritableObjectValue<T>Параметры:
value- Новое значениеИсключение:
UndeclaredThrowableException- если вызов геттера свойства Java Bean вызываетIllegalAccessExceptionилиInvocationTargetException.См. также:
-
bind
public void bind(ObservableValue<? extends T> observable)
Создайте однонаправленную привязку для этогоProperty.Обратите внимание, что JavaFX реализует все вызовы bind через слабые слушатели. Это означает, что связанное свойство может быть собрано сборщиком мусора и остановлено от обновления.
-
unbind
public void unbind()
Удалите однонаправленную привязку для этогоProperty. ЕслиPropertyне привязано, вызов этого метода не оказывает никакого влияния.
-
isBound
public boolean isBound()
Может использоваться для проверки, привязано лиProperty.Возвращает:
true, еслиPropertyпривязано,falseв противном случае
-
getBean
public Object getBean()
ВозвращаетObject, содержащий это свойство. Если это свойство не содержится вObject, возвращаетсяnull.Указано:
getBeanв интерфейсеReadOnlyProperty<T>Возвращает:
содержащий
Objectилиnull
-
getName
public String getName()
Возвращает имя этого свойства. Если свойство не имеет имени, этот метод возвращает пустуюString.Указано:
getNameв интерфейсеReadOnlyProperty<T>Возвращает:
имя или пустую
String
-
addListener
public void addListener(ChangeListener<? super T> listener)
ДобавляетChangeListener, который будет уведомляться всякий раз, когда значениеObservableValueменяется. Если один и тот же слушатель добавляется более одного раза, он будет уведомляться более одного раза. То есть никакая проверка на уникальность не производится.Обратите внимание, что один и тот же фактический экземпляр
ChangeListenerможет быть безопасно зарегистрирован для разныхObservableValues.ObservableValueхранит сильную ссылку на слушателя, что предотвращает сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвавremoveListenerпосле использования, либо использовать экземплярWeakChangeListenerдля предотвращения этой ситуации.Указано:
addListenerв интерфейсеObservableValue<T>Параметры:
listener- слушатель для регистрации
-
removeListener
public void removeListener(ChangeListener<? super T> listener)
Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableValueменяется.Если заданный слушатель ранее не был зарегистрирован (т. е. никогда не был добавлен), то вызов этого метода является бесполезной операцией. Если он был ранее добавлен, то он будет удален. Если он был добавлен более одного раза, то будет удалена только первая запись.
Указано:
removeListenerв интерфейсеObservableValue<T>Параметры:
listener- слушатель для удаленияСм. также:
-
addListener
public void addListener(InvalidationListener listener)
ДобавляетInvalidationListener, который будет уведомляться всякий раз, когдаObservableстановится недействительным. Если один и тот же слушатель добавляется более одного раза, он будет уведомляться более одного раза. То есть никакая проверка на уникальность не производится.Обратите внимание, что один и тот же фактический экземпляр
InvalidationListenerможет быть безопасно зарегистрирован для разныхObservables.Observableхранит сильную ссылку на слушателя, что предотвращает сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвавremoveListenerпосле использования, либо использовать экземплярWeakInvalidationListenerдля предотвращения этой ситуации.Указано:
addListenerв интерфейсеObservableПараметры:
listener- слушатель для регистрации
-
removeListener
public void removeListener(InvalidationListener listener)
Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableстановится недействительным.Если заданный слушатель ранее не был зарегистрирован (т. е. никогда не был добавлен), то вызов этого метода является бесполезной операцией. Если он был ранее добавлен, то он будет удален. Если он был добавлен более одного раза, то будет удалена только первая запись.
Указано:
removeListenerв интерфейсеObservableПараметры:
listener- слушатель для удаленияСм. также:
-
fireValueChangedEvent
public void fireValueChangedEvent()
Этот метод можно вызвать, чтобы уведомить адаптер об изменении значения свойства Java Bean, если свойство Java Bean не привязано (т. е. не поддерживает PropertyChangeListeners).Указано:
fireValueChangedEventв интерфейсеReadOnlyJavaBeanProperty<T>
-
dispose
public void dispose()
Сигнализирует свойству JavaFX, что оно больше не будет использоваться, и любые ссылки могут быть удалены. Вызов этого метода обычно приводит к прекращению наблюдения свойством за свойством Java Bean путем отмены регистрации его слушателей.Указано:
disposeв интерфейсеReadOnlyJavaBeanProperty<T>
-
toString
public String toString()
Возвращает строковое представление этого объектаJavaBeanObjectProperty.Переопределяет:
toStringв классеObjectProperty<T>Возвращает:
строковое представление этого объекта
JavaBeanObjectProperty.
-
© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.