- java.lang.Object
-
- javafx.beans.binding.ListExpression<E>
-
- Type Parameters:
E- the type of theListelements.
- All Implemented Interfaces:
Iterable<E>,Collection<E>,List<E>,Observable,ObservableListValue<E>,ObservableObjectValue<ObservableList<E>>,ObservableValue<ObservableList<E>>,ObservableList<E>
- Direct Known Subclasses:
ListBinding,ReadOnlyListProperty
public abstract class ListExpression<E> extends Object implements ObservableListValue<E>
ListExpressionis anObservableListValueplus additional convenience methods to generate bindings in a fluent style.A concrete sub-class of
ListExpressionhas to implement the methodObservableObjectValue.get(), which provides the actual value of this expression.If the wrapped list of a
ListExpressionisnull, all methods implementing theListinterface will behave as if they were applied to an immutable empty list.- Since:
- JavaFX 2.1
-
-
Property Summary
Properties Type Property Description abstract ReadOnlyBooleanPropertyemptyA boolean property that istrue, if the list is empty.abstract ReadOnlyIntegerPropertysizeAn integer property that represents the size of the list.
-
Constructor Summary
Constructors Constructor Description ListExpression()Creates a defaultListExpression.
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description StringBindingasString()abstract ReadOnlyBooleanPropertyemptyProperty()A boolean property that istrue, if the list is empty.intgetSize()The size of the listBooleanBindingisEqualTo(ObservableList<?> other)BooleanBindingisNotEqualTo(ObservableList<?> other)BooleanBindingisNotNull()BooleanBindingisNull()static <E> ListExpression<E>listExpression(ObservableListValue<E> value)Returns aListExpressionthat wraps aObservableListValue.abstract ReadOnlyIntegerPropertysizeProperty()An integer property that represents the size of the list.ObjectBinding<E>valueAt(int index)Creates a newObjectBindingthat contains the element at the specified position.ObjectBinding<E>valueAt(ObservableIntegerValue index)Creates a newObjectBindingthat contains the element at the specified position.-
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods declared in interface java.util.Collection
parallelStream, removeIf, stream, toArray
-
Methods declared in interface java.util.List
add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray
-
Methods declared in interface javafx.beans.Observable
addListener, removeListener
-
Methods declared in interface javafx.collections.ObservableList
addAll, addListener, filtered, remove, removeAll, removeListener, retainAll, setAll, setAll, sorted, sorted
-
Methods declared in interface javafx.beans.value.ObservableObjectValue
get
-
Methods declared in interface javafx.beans.value.ObservableValue
addListener, getValue, removeListener
-
-
-
-
Property Detail
-
size
public abstract ReadOnlyIntegerProperty sizeProperty
An integer property that represents the size of the list.- See Also:
getSize()
-
empty
public abstract ReadOnlyBooleanProperty emptyProperty
A boolean property that istrue, if the list is empty.- See Also:
List.isEmpty()
-
-
Method Detail
-
listExpression
public static <E> ListExpression<E> listExpression(ObservableListValue<E> value)
Returns aListExpressionthat wraps aObservableListValue. If theObservableListValueis already aListExpression, it will be returned. Otherwise a newListBindingis created that is bound to theObservableListValue.- Type Parameters:
E- the type of the wrappedList- Parameters:
value- The sourceObservableListValue- Returns:
- A
ListExpressionthat wraps theObservableListValueif necessary - Throws:
NullPointerException- ifvalueisnull
-
getSize
public int getSize()
The size of the list- Returns:
- the size
-
sizeProperty
public abstract ReadOnlyIntegerProperty sizeProperty()
An integer property that represents the size of the list.- See Also:
getSize()
-
emptyProperty
public abstract ReadOnlyBooleanProperty emptyProperty()
A boolean property that istrue, if the list is empty.- See Also:
List.isEmpty()
-
valueAt
public ObjectBinding<E> valueAt(int index)
Creates a newObjectBindingthat contains the element at the specified position. Ifindexpoints behind the list, theObjectBindingcontainsnull.- Parameters:
index- the index of the element- Returns:
- the
ObjectBinding - Throws:
IllegalArgumentException- ifindex < 0
-
valueAt
public ObjectBinding<E> valueAt(ObservableIntegerValue index)
Creates a newObjectBindingthat contains the element at the specified position. Ifindexpoints outside of the list, theObjectBindingcontainsnull.- Parameters:
index- the index of the element- Returns:
- the
ObjectBinding - Throws:
NullPointerException- ifindexisnull
-
isEqualTo
public BooleanBinding isEqualTo(ObservableList<?> other)
- Parameters:
other- the otherObservableList- Returns:
- the new
BooleanBinding - Throws:
NullPointerException- ifotherisnull
-
isNotEqualTo
public BooleanBinding isNotEqualTo(ObservableList<?> other)
- Parameters:
other- the otherObservableList- Returns:
- the new
BooleanBinding - Throws:
NullPointerException- ifotherisnull
-
isNull
public BooleanBinding isNull()
- Returns:
- the new
BooleanBinding
-
isNotNull
public BooleanBinding isNotNull()
- Returns:
- the new
BooleanBinding
-
asString
public StringBinding asString()
Creates aStringBindingthat holds the value of theListExpressionturned into aString. If the value of thisListExpressionchanges, the value of theStringBindingwill be updated automatically.- Returns:
- the new
StringBinding
-
-