Класс JavaBeanStringProperty
- javafx.beans.binding.StringExpression
-
- javafx.beans.property.ReadOnlyStringProperty
-
- javafx.beans.property.StringProperty
-
- javafx.beans.property.adapter.JavaBeanStringProperty
Все реализованные интерфейсы:
Observable, JavaBeanProperty<String>, ReadOnlyJavaBeanProperty<String>, Property<String>, ReadOnlyProperty<String>, ObservableObjectValue<String>, ObservableStringValue, ObservableValue<String>, WritableObjectValue<String>, WritableStringValue, WritableValue<String>
public final class JavaBeanStringProperty extends StringProperty implements JavaBeanProperty<String>
JavaBeanStringProperty предоставляет адаптер между обычным свойством Java Bean типа String и JavaFX-свойством StringProperty. Его нельзя создать напрямую, необходимо использовать JavaBeanStringPropertyBuilder. Как минимум, свойство Java Bean должно иметь геттер и сеттер. Если вызывается геттер экземпляра этого класса, возвращается свойство Java Bean. Если вызывается сеттер, значение передаётся в свойство Java Bean. Если свойство Java Bean привязано (т.е. поддерживает PropertyChangeListeners), это JavaBeanStringProperty будет отслеживать изменения в Java Bean. В противном случае можно оповестить об изменениях, вызвав fireValueChangedEvent(). Если свойство Java Bean также ограничено (т.е. поддерживает VetoableChangeListeners), это JavaBeanStringProperty отклонит изменения, если оно привязано к ObservableValue<String>.
С момента:
JavaFX 2.1
См. также:
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод и описание voidaddListener(ChangeListener<? super String> listener)ДобавляетChangeListener, который будет оповещён всякий раз, когда значениеObservableValueизменяется.voidaddListener(InvalidationListener listener)ДобавляетInvalidationListener, который будет оповещён всякий раз, когдаObservableстановится недействительным.voidbind(ObservableValue<? extends String> observable)Создаёт однонаправленную привязку для этогоProperty.voiddispose()Сигнализирует JavaFX-свойству, что оно больше не будет использоваться, и любые ссылки могут быть удалены.voidfireValueChangedEvent()Этот метод может быть вызван для оповещения адаптера об изменении значения Java Bean, если свойство Java Bean не привязано (т.е.Stringget()Получить обернутое значение.ObjectgetBean()ВозвращаетObject, содержащий это свойство.StringgetName()Возвращает имя этого свойства.booleanisBound()Можно использовать для проверки, еслиPropertyпривязано.voidremoveListener(ChangeListener<? super String> listener)Удаляет заданного слушателя из списка слушателей, которые оповещаются всякий раз, когда значениеObservableValueизменяется.voidremoveListener(InvalidationListener listener)Удаляет заданного слушателя из списка слушателей, которые оповещаются всякий раз, когда значениеObservableстановится недействительным.voidset(String value)Установить обернутое значение.voidunbind()Удалить однонаправленную привязку для этогоProperty.-
Методы, унаследованные от класса javafx.beans.property.StringProperty
bindBidirectional, bindBidirectional, bindBidirectional, setValue, toString, unbindBidirectional, unbindBidirectional
-
Методы, унаследованные от класса javafx.beans.binding.StringExpression
concat, getValue, getValueSafe, greaterThan, greaterThan, greaterThanOrEqualTo, greaterThanOrEqualTo, isEmpty, isEqualTo, isEqualTo, isEqualToIgnoreCase, isEqualToIgnoreCase, isNotEmpty, isNotEqualTo, isNotEqualTo, isNotEqualToIgnoreCase, isNotEqualToIgnoreCase, isNotNull, isNull, length, lessThan, lessThan, lessThanOrEqualTo, lessThanOrEqualTo, stringExpression
-
Методы, унаследованные от класса 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
-
-
Метод Detail
-
get
public String get()
Получить обернутое значение. Оно должно быть идентично значению, возвращаемому изWritableValue.getValue().Этот метод существует только для согласования API WritableObjectValue с
WritableBooleanValueи подклассамиWritableNumberValueОпределено в:
getв интерфейсеObservableObjectValue<String>Определено в:
getв интерфейсеWritableObjectValue<String>Возвращает:
Текущее значение
Исключения:
UndeclaredThrowableException- если вызов метода-геттера свойства Java Bean вызываетIllegalAccessExceptionилиInvocationTargetException.
-
set
public void set(String value)
Установить обернутое значение. Должно быть эквивалентноWritableValue.setValue(java.lang.Object)Определено в:
setв интерфейсеWritableObjectValue<String>Параметры:
value- Новое значениеИсключения:
UndeclaredThrowableException- если вызов метода-геттера свойства Java Bean вызываетIllegalAccessExceptionилиInvocationTargetException.См. также:
-
bind
public void bind(ObservableValue<? extends String> 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<String>Возвращает:
содержащую
Objectилиnull
-
getName
public String getName()
Возвращает имя этого свойства. Если свойство не имеет имени, этот метод возвращает пустуюString.Определено в:
getNameв интерфейсеReadOnlyProperty<String>Возвращает:
имя или пустую
String
-
addListener
public void addListener(ChangeListener<? super String> listener)
ДобавляетChangeListener, который будет уведомлен всякий раз, когда значениеObservableValueизменяется. Если один и тот же слушатель добавляется более одного раза, он будет уведомлен более одного раза. То есть не проверяется уникальность.Обратите внимание, что один и тот же фактический экземпляр
ChangeListenerможет быть безопасно зарегистрирован для разныхObservableValues.ObservableValueхранит сильную ссылку на слушателя, что предотвращает сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвавremoveListenerпосле использования, либо использовать экземплярWeakChangeListener, чтобы избежать этой ситуации.Определено в:
addListenerв интерфейсеObservableValue<String>Параметры:
listener- Слушатель для регистрации
-
removeListener
public void removeListener(ChangeListener<? super String> listener)
Удаляет указанного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableValueизменяется.Если указанный слушатель ранее не был зарегистрирован (т. е. его никогда не добавляли), то этот вызов метода является пустым. Если он был добавлен ранее, он будет удален. Если он был добавлен более одного раза, то будет удалена только первая запись.
Определено в:
removeListenerв интерфейсеObservableValue<String>Параметры:
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<String>
-
dispose
public void dispose()
Сигнализирует свойству JavaFX, что оно больше не будет использоваться, и все ссылки могут быть удалены. Вызов этого метода обычно приводит к прекращению наблюдения свойством за свойством Java Bean путем отмены регистрации его слушателя(ей).Определено в:
disposeв интерфейсеReadOnlyJavaBeanProperty<String>
-
© 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.