Класс ListBinding<E>
- javafx.beans.binding.ListExpression<E>
-
- javafx.beans.binding.ListBinding<E>
Параметры типа:
E — тип элемента List
Все реализуемые интерфейсы:
Iterable<E>, Collection<E>, List<E>, Binding<ObservableList<E>>, Observable, ObservableListValue<E>, ObservableObjectValue<ObservableList<E>>, ObservableValue<ObservableList<E>>, ObservableList<E>
public abstract class ListBinding<E> extends ListExpression<E> implements Binding<ObservableList<E>>
Binding для ObservableList. ListBinding использует простую схему проверки на недействительность. Расширяющий класс может регистрировать зависимости, вызывая bind(Observable...). Если одна из зарегистрированных зависимостей становится недействительной, этот ListBinding отмечается как недействительный. С помощью unbind(Observable...) можно остановить прослушивание зависимостей.
Для предоставления конкретной реализации этого класса, необходимо реализовать метод computeValue() для расчёта значения этого привязывания на основе текущего состояния зависимостей. Он вызывается при вызове get() для недействительного привязывания.
Смотрите DoubleBinding для примера того, как можно расширить этот базовый класс.
С:
JavaFX 2.1
См. также:
-
Краткое описание свойств
Все методыМетоды экземпляровКонкретные методы Тип Свойство и описание ReadOnlyBooleanPropertyemptyЛогическое свойство, которое равноtrue, если список пуст.ReadOnlyIntegerPropertysizeЦелочисленное свойство, представляющее размер списка.
-
Краткое описание конструкторов
Конструкторы Конструктор и описание ListBinding()
-
Краткое описание методов
Все методыМетоды экземпляровАбстрактные методыКонкретные методы Модификатор и тип Метод и описание voidaddListener(ChangeListener<? super ObservableList<E>> listener)ДобавляетChangeListener, который будет уведомляться всякий раз, когда изменяется значениеObservableValue.voidaddListener(InvalidationListener listener)ДобавляетInvalidationListener, который будет уведомляться всякий раз, когдаObservableстановится недействительным.voidaddListener(ListChangeListener<? super E> listener)Добавить слушателя в этот список наблюдаемых.protected voidbind(Observable... dependencies)Начать наблюдение за изменениями в зависимостях.protected abstract ObservableList<E>computeValue()Вычисляет текущее значение этого привязывания.voiddispose()Стандартная реализацияdispose(), которая пуста.ReadOnlyBooleanPropertyemptyProperty()Логическое свойство, которое равноtrue, если список пуст.ObservableList<E>get()Возвращает результатcomputeValue().ObservableList<?>getDependencies()Стандартная реализацияgetDependencies(), которая возвращает пустойObservableList.voidinvalidate()Отметить привязывание как недействительное.booleanisValid()Проверяет, является ли привязывание действительным.protected voidonInvalidating()Метод onInvalidating() может быть переопределён подклассами для реакции, если это привязывание становится недействительным.voidremoveListener(ChangeListener<? super ObservableList<E>> listener)Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда изменяется значениеObservableValue.voidremoveListener(InvalidationListener listener)Удаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableстановится недействительным.voidremoveListener(ListChangeListener<? super E> listener)Попытка удалить слушателя из этого наблюдаемого списка.ReadOnlyIntegerPropertysizeProperty()Целочисленное свойство, представляющее размер списка.StringtoString()Возвращает строковое представление этого объектаListBinding.protected voidunbind(Observable... dependencies)Остановить наблюдение за изменениями в зависимостях.-
Методы, унаследованные от класса javafx.beans.binding.ListExpression
add, add, addAll, addAll, addAll, asString, clear, contains, containsAll, get, getSize, getValue, indexOf, isEmpty, isEqualTo, isNotEqualTo, isNotNull, isNull, iterator, lastIndexOf, listExpression, listIterator, listIterator, remove, remove, remove, removeAll, removeAll, retainAll, retainAll, set, setAll, setAll, size, subList, toArray, toArray, valueAt, valueAt
-
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Методы, унаследованные от интерфейса javafx.beans.value.ObservableValue
getValue
-
Методы, унаследованные от интерфейса javafx.collections.ObservableList
filtered, sorted, sorted
-
Методы, унаследованные от интерфейса java.util.List
equals, hashCode, replaceAll, sort, spliterator
-
Методы, унаследованные от интерфейса java.util.Collection
parallelStream, removeIf, stream
-
-
Подробное описание свойства
-
size
public ReadOnlyIntegerProperty sizeProperty
Определено:
sizePropertyв классеListExpression<E>Возвращает:
свойство
-
empty
public ReadOnlyBooleanProperty emptyProperty
Определено:
emptyPropertyв классеListExpression<E>
-
-
Подробное описание конструктора
-
ListBinding
public ListBinding()
-
-
Подробное описание метода
-
sizeProperty
public ReadOnlyIntegerProperty sizeProperty()
Описание скопировано из класса:ListExpressionЦелочисленное свойство, представляющее размер списка.Определено:
sizePropertyв классеListExpression<E>Возвращает:
свойство
-
emptyProperty
public ReadOnlyBooleanProperty emptyProperty()
Описание скопировано из класса:ListExpressionЛогическое свойство, которое равноtrue, если список пуст.Определено:
emptyPropertyв классеListExpression<E>
-
addListener
public void addListener(InvalidationListener listener)
Описание скопировано из интерфейса:ObservableДобавляет слушателяInvalidationListener, который будет уведомляться всякий раз, когдаObservableстановится недействительным. Если один и тот же слушатель добавляется более одного раза, то он будет уведомляться более одного раза. Не выполняется проверка уникальности.Обратите внимание, что один и тот же фактический экземпляр
InvalidationListenerможет быть безопасно зарегистрирован для различныхObservables.Observableхранит сильную ссылку на слушателя, что предотвращает сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвавremoveListenerпосле использования, либо использовать экземплярWeakInvalidationListener, чтобы избежать этой ситуации.Определено:
addListenerв интерфейсеObservableПараметры:
listener- Слушатель для регистрации
-
removeListener
public void removeListener(InvalidationListener listener)
Описание скопировано из интерфейса:ObservableУдаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableстановится недействительным.Если заданный слушатель не был зарегистрирован ранее (т. е. его никогда не добавляли), то этот вызов метода не имеет эффекта. Если он был добавлен ранее, он будет удален. Если он был добавлен более одного раза, то будет удалён только первый экземпляр.
Определено:
removeListenerв интерфейсеObservableПараметры:
listener- Слушатель для удаленияСм. также:
-
addListener
public void addListener(ChangeListener<? super ObservableList<E>> listener)
Описание скопировано из интерфейса:ObservableValueДобавляет слушателяChangeListener, который будет уведомляться всякий раз, когда значениеObservableValueизменяется. Если один и тот же слушатель добавляется более одного раза, то он будет уведомляться более одного раза. Не выполняется проверка уникальности.Обратите внимание, что один и тот же фактический экземпляр
ChangeListenerможет быть безопасно зарегистрирован для различныхObservableValues.ObservableValueхранит сильную ссылку на слушателя, что предотвращает сборку мусора слушателя и может привести к утечке памяти. Рекомендуется либо отменить регистрацию слушателя, вызвавremoveListenerпосле использования, либо использовать экземплярWeakChangeListener, чтобы избежать этой ситуации.Определено:
addListenerв интерфейсеObservableValue<ObservableList<E>>Параметры:
listener- Слушатель для регистрации
-
removeListener
public void removeListener(ChangeListener<? super ObservableList<E>> listener)
Описание скопировано из интерфейса:ObservableValueУдаляет заданного слушателя из списка слушателей, которые уведомляются всякий раз, когда значениеObservableValueизменяется.Если заданный слушатель не был зарегистрирован ранее (т. е. его никогда не добавляли), то этот вызов метода не имеет эффекта. Если он был добавлен ранее, он будет удален. Если он был добавлен более одного раза, то будет удалён только первый экземпляр.
Определено:
removeListenerв интерфейсеObservableValue<ObservableList<E>>Параметры:
listener- Слушатель для удаленияСм. также:
-
addListener
public void addListener(ListChangeListener<? super E> listener)
Описание скопировано из интерфейса:ObservableListДобавляет слушателя к этому наблюдаемому списку.Определено:
addListenerв интерфейсеObservableList<E>Параметры:
listener- слушатель для прослушивания изменений в списке
-
removeListener
public void removeListener(ListChangeListener<? super E> listener)
Описание скопировано из интерфейса:ObservableListПытается удалить слушателя из этого наблюдаемого списка. Если слушатель не прикреплён к этому списку, ничего не происходит.Определено:
removeListenerв интерфейсеObservableList<E>Параметры:
listener- слушатель для удаления
-
bind
protected final void bind(Observable... dependencies)
Начинает наблюдение за зависимостями для обнаружения изменений. Если значение одной из зависимостей изменяется, привязка помечается как недействительная.Параметры:
dependencies- зависимости для наблюдения
-
unbind
protected final void unbind(Observable... dependencies)
Прекращает наблюдение за зависимостями для обнаружения изменений.Параметры:
dependencies- зависимости для прекращения наблюдения
-
dispose
public void dispose()
Реализация по умолчаниюdispose(), которая пуста.Определено:
disposeв интерфейсеBinding<ObservableList<E>>
-
getDependencies
public ObservableList<?> getDependencies()
Реализация по умолчаниюgetDependencies(), которая возвращает пустойObservableList.Определено:
getDependenciesв интерфейсеBinding<ObservableList<E>>Возвращает:
пустой
ObservableList
-
get
public final ObservableList<E> get()
Возвращает результатcomputeValue(). МетодcomputeValue()вызывается только в том случае, если привязка становится недействительной. Результат кэшируется и возвращается, если привязка не стала недействительной с момента последнего вызоваget().Определено:
getв интерфейсеObservableObjectValue<ObservableList<E>>Возвращает:
текущее значение
-
onInvalidating
protected void onInvalidating()
Метод onInvalidating() может быть переопределён подклассами для реакции на то, что эта привязка становится недействительной. Реализация по умолчанию пуста.
-
invalidate
public final void invalidate()
Описание скопировано из интерфейса:BindingПомечает привязку как недействительную. Это принудительно пересчитывает значениеBindingв следующий раз, когда оно запрашивается.Определено:
invalidateв интерфейсеBinding<ObservableList<E>>
-
isValid
public final boolean isValid()
Описание скопировано из интерфейса:BindingПроверяет, является ли привязка действительной.Определено:
isValidв интерфейсеBinding<ObservableList<E>>Возвращает:
true, еслиBindingдействительна,falseв противном случае
-
computeValue
protected abstract ObservableList<E> computeValue()
Вычисляет текущее значение этой привязки.Классы, расширяющие
ListBinding, должны предоставить реализациюcomputeValue.Возвращает:
текущее значение
-
toString
public String toString()
Возвращает строковое представление этого объектаListBinding.
-
© 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.