Класс StringPropertyBase

javafx.beans.property.StringPropertyBase

Все реализованные интерфейсы:: Observable, Property<String>, ReadOnlyProperty<String>, ObservableObjectValue<String>, ObservableStringValue, ObservableValue<String>, WritableObjectValue<String>, WritableStringValue, WritableValue<String>

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

public abstract class StringPropertyBase extends StringProperty

Класс StringPropertyBase является базовым классом для свойства, оборачивающего значение String. Он предоставляет всю необходимую функциональность для свойства, за исключением методов ReadOnlyProperty.getBean() и ReadOnlyProperty.getName(), которые должны быть реализованы расширяющими классами.

С тех пор:

JavaFX 2.0

См. также:

StringProperty

Краткое описание конструкторов

Конструктор	Описание
`StringPropertyBase()`	Конструктор `StringPropertyBase`.
`StringPropertyBase(String initialValue)`	Конструктор `StringPropertyBase`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addListener(InvalidationListener listener)`	Добавляет слушатель `InvalidationListener`, который будет уведомлен всякий раз, когда `Observable` станет недоступным.
`void`	`addListener(ChangeListener<? super String> listener)`	Добавляет слушателя `ChangeListener`, который будет уведомлен всякий раз, когда значение `ObservableValue` изменится.
`void`	`bind(ObservableValue<? extends String> newObservable)`	Создает однонаправленную привязку для данного `Property`.
`protected void`	`fireValueChangedEvent()`	Отправляет уведомления всем прикрепленным слушателям `InvalidationListeners` и `ChangeListeners`.
`String`	`get()`	Получить обернутое значение.
`protected void`	`invalidated()`	Метод `invalidated()` можно переопределить для получения уведомлений о недействительности.
`boolean`	`isBound()`	Может использоваться для проверки, привязано ли данное `Property`.
`void`	`removeListener(InvalidationListener listener)`	Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение `Observable` становится недействительным.
`void`	`removeListener(ChangeListener<? super String> listener)`	Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение `ObservableValue` меняется.
`void`	`set(String newValue)`	Установить обернутое значение.
`String`	`toString()`	Возвращает строковое представление этого объекта `StringPropertyBase`.
`void`	`unbind()`	Удалить однонаправленную привязку для данного `Property`.

Методы, объявленные в классе javafx.beans.property.StringProperty

bindBidirectional, bindBidirectional, bindBidirectional, setValue, 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.Observable

subscribe

Методы, объявленные в интерфейсе javafx.beans.value.ObservableValue

flatMap, getValue, map, orElse, subscribe, subscribe, when

Методы, объявленные в интерфейсе javafx.beans.property.ReadOnlyProperty

getBean, getName

Методы, объявленные в интерфейсе javafx.beans.value.WritableValue

getValue

Подробное описание конструкторов

StringPropertyBase

public StringPropertyBase()

Конструктор StringPropertyBase.

StringPropertyBase

public StringPropertyBase(String initialValue)

Конструктор StringPropertyBase.

Параметры:: initialValue - начальное значение обернутого String

Подробное описание методов

addListener

public void addListener(InvalidationListener listener)

Описание, скопированное из интерфейса: Observable

Добавляет InvalidationListener, который будет уведомляться всякий раз, когда Observable становится недействительным. Если один и тот же слушатель добавляется более одного раза, он будет уведомляться более одного раза. То есть, проверка уникальности не выполняется.

Обратите внимание, что один и тот же экземпляр фактического InvalidationListener может быть безопасно зарегистрирован для разных Observables.

Observable хранит сильную ссылку на слушателя, что предотвращает сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвав removeListener после использования, либо использовать экземпляр WeakInvalidationListener, чтобы избежать этой ситуации.

Параметры:

listener - слушатель для регистрации

См. также:

Observable.removeListener(InvalidationListener)

removeListener

public void removeListener(InvalidationListener listener)

Описание, скопированное из интерфейса: Observable

Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение Observable становится недействительным.

Если заданный слушатель ранее не был зарегистрирован (т. е. никогда не добавлялся), то вызов этого метода является бесполезным. Если он был ранее добавлен, то он будет удален. Если он был добавлен более одного раза, то будет удалён только первый случай.

Параметры:

listener - слушатель для удаления

См. также:

Observable.addListener(InvalidationListener)

addListener

public void addListener(ChangeListener<? super String> listener)

Описание, скопированное из интерфейса: ObservableValue

Добавляет ChangeListener, который будет уведомляться всякий раз, когда значение ObservableValue изменяется. Если один и тот же слушатель добавляется более одного раза, он будет уведомляться более одного раза. То есть, проверка уникальности не выполняется.

Обратите внимание, что один и тот же экземпляр фактического ChangeListener может быть безопасно зарегистрирован для разных ObservableValues.

ObservableValue хранит сильную ссылку на слушателя, что предотвращает сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвав removeListener после использования, либо использовать экземпляр WeakChangeListener, чтобы избежать этой ситуации.

Параметры:

listener - слушатель для регистрации

См. также:

ObservableValue.removeListener(ChangeListener)

removeListener

public void removeListener(ChangeListener<? super String> listener)

Описание, скопированное из интерфейса: ObservableValue

Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение ObservableValue изменяется.

Параметры:

listener - слушатель для удаления

См. также:

ObservableValue.addListener(ChangeListener)

fireValueChangedEvent

protected void fireValueChangedEvent()

Отправляет уведомления всем присоединённым InvalidationListeners и ChangeListeners. Этот метод вызывается при изменении значения, либо вручную, вызвав set(java.lang.String), либо в случае связанной свойства, если привязка становится недействительной.

invalidated

protected void invalidated()

Метод invalidated() может быть переопределён, чтобы получать уведомления о недействительности. Это предпочтительный вариант при Objects определении свойства, так как он требует меньше памяти. По умолчанию реализация пуста.

get

public String get()

Получить обернутое значение. Оно должно быть идентично значению, возвращаемому из WritableValue.getValue().

Этот метод существует только для соответствия API WritableObjectValue с WritableBooleanValue и подклассами WritableNumberValue

Возвращает:: Текущее значение

set

public void set(String newValue)

Установить обернутое значение. Должно быть эквивалентно WritableValue.setValue(java.lang.Object)

Параметры:

newValue - новое значение

См. также:

WritableObjectValue.get()

isBound

public boolean isBound()

Может использоваться для проверки, если Property привязана.

Возвращает:

true, если Property привязана, false в противном случае

См. также:

Property.bind(javafx.beans.value.ObservableValue)

bind

public void bind(ObservableValue<? extends String> newObservable)

Создаёт однонаправленную привязку для этого Property.

Обратите внимание, что JavaFX имеет все вызовы bind реализованные через слабые слушатели. Это означает, что связанное свойство может быть собрано мусором и остановлено от обновления.

Параметры:: newObservable - наблюдаемое, к которому должно быть привязано это Property.

unbind

public void unbind()

Удаляет однонаправленную привязку для этого Property. Если Property не привязана, вызов этого метода не имеет эффекта.

См. также:

Property.bind(javafx.beans.value.ObservableValue)

toString

public String toString()

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

Переопределяет:: toString в классе StringProperty
Возвращает:: строковое представление этого StringPropertyBase объекта.

© 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.