Spec-Zone.ru › OpenJavaFX 8
javafx.beans.property.adapter

Класс JavaBeanStringProperty

java.lang.Object
  • 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

См. также:

StringProperty, JavaBeanStringPropertyBuilder

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

    Все методыМетоды экземпляраКонкретные методы
    Модификатор и тип Метод и описание
    void addListener(ChangeListener<? super String> listener)
    Добавляет ChangeListener, который будет оповещён всякий раз, когда значение ObservableValue изменяется.
    void addListener(InvalidationListener listener)
    Добавляет InvalidationListener, который будет оповещён всякий раз, когда Observable становится недействительным.
    void bind(ObservableValue<? extends String> observable)
    Создаёт однонаправленную привязку для этого Property.
    void dispose()
    Сигнализирует JavaFX-свойству, что оно больше не будет использоваться, и любые ссылки могут быть удалены.
    void fireValueChangedEvent()
    Этот метод может быть вызван для оповещения адаптера об изменении значения Java Bean, если свойство Java Bean не привязано (т.е.
    String get()
    Получить обернутое значение.
    Object getBean()
    Возвращает Object, содержащий это свойство.
    String getName()
    Возвращает имя этого свойства.
    boolean isBound()
    Можно использовать для проверки, если Property привязано.
    void removeListener(ChangeListener<? super String> listener)
    Удаляет заданного слушателя из списка слушателей, которые оповещаются всякий раз, когда значение ObservableValue изменяется.
    void removeListener(InvalidationListener listener)
    Удаляет заданного слушателя из списка слушателей, которые оповещаются всякий раз, когда значение Observable становится недействительным.
    void set(String value)
    Установить обернутое значение.
    void unbind()
    Удалить однонаправленную привязку для этого 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.

      См. также:

      WritableObjectValue.get()

    • bind

      public void bind(ObservableValue<? extends String> observable)
      Создать однонаправленную привязку для этого Property.

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

      Определено в:

      bind в интерфейсе Property<String>

      Параметры:

      observable - Наблюдаемое свойство, к которому должно быть привязано это Property.

    • unbind

      public void unbind()
      Удалить однонаправленную привязку для этого Property. Если Property не привязано, вызов этого метода не окажет никакого эффекта.

      Определено в:

      unbind в интерфейсе Property<String>

      См. также:

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

    • isBound

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

      Определено в:

      isBound в интерфейсе Property<String>

      Возвращает:

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

      См. также:

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

    • 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 - Слушатель для регистрации

      См. также:

      ObservableValue.removeListener(ChangeListener)

    • removeListener

      public void removeListener(ChangeListener<? super String> listener)
      Удаляет указанного слушателя из списка слушателей, которые уведомляются всякий раз, когда значение ObservableValue изменяется.

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

      Определено в:

      removeListener в интерфейсе ObservableValue<String>

      Параметры:

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

      См. также:

      ObservableValue.addListener(ChangeListener)

    • addListener

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

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

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

      Определено в:

      addListener в интерфейсе Observable

      Параметры:

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

      См. также:

      Observable.removeListener(InvalidationListener)

    • removeListener

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

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

      Определено в:

      removeListener в интерфейсе Observable

      Параметры:

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

      См. также:

      Observable.addListener(InvalidationListener)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API