java.lang.Object
java.util.AbstractCollection<E>
java.util.AbstractList<E>
javafx.collections.ObservableListBase<E>
javafx.collections.transformation.TransformationList<E,E>
javafx.collections.transformation.SortedList<E>
- All Implemented Interfaces:
Iterable<E>
,Collection<E>
,List<E>
,Observable
,ObservableList<E>
public final class SortedList<E> extends TransformationList<E,E>
Wraps an ObservableList and sorts its content.
All changes in the ObservableList are propagated immediately
to the SortedList.
Note: invalid SortedList (as a result of broken comparison) doesn't send any notification to listeners on becoming
valid again.
- Since:
- JavaFX 8.0
- See Also:
TransformationList
-
Property Summary
Properties Type Property Description ObjectProperty<Comparator<? super E>>
comparator
The comparator that denotes the order of this SortedList. -
Field Summary
Fields inherited from class java.util.AbstractList
modCount
-
Constructor Summary
Constructors Constructor Description SortedList(ObservableList<? extends E> source)
Constructs a new unordered SortedList wrapper around the source list.SortedList(ObservableList<? extends E> source, Comparator<? super E> comparator)
Creates a new SortedList wrapped around the source list. -
Method Summary
Modifier and Type Method Description ObjectProperty<Comparator<? super E>>
comparatorProperty()
The comparator that denotes the order of this SortedList.E
get(int index)
Returns the element at the specified position in this list.Comparator<? super E>
getComparator()
Gets the value of the property comparator.int
getSourceIndex(int index)
Maps the index of this list's element to an index in the direct source list.int
getViewIndex(int index)
Maps the index of the direct source list's element to an index in this list.void
setComparator(Comparator<? super E> comparator)
Sets the value of the property comparator.int
size()
Returns the number of elements in this list.protected void
sourceChanged(ListChangeListener.Change<? extends E> c)
Called when a change from the source is triggered.Methods inherited from class javafx.collections.transformation.TransformationList
getSource, getSourceIndexFor, isInTransformationChain
Methods inherited from class javafx.collections.ObservableListBase
addAll, addListener, addListener, beginChange, endChange, fireChange, hasListeners, nextAdd, nextPermutation, nextRemove, nextRemove, nextReplace, nextSet, nextUpdate, remove, removeAll, removeListener, removeListener, retainAll, setAll, setAll
Methods inherited from class java.util.AbstractList
add, add, addAll, clear, equals, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, remove, removeRange, set, subList
Methods inherited from class java.util.AbstractCollection
addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toString
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface java.util.Collection
parallelStream, removeIf, stream, toArray
Methods inherited from interface java.util.List
add, add, addAll, addAll, clear, contains, containsAll, equals, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, sort, spliterator, subList, toArray, toArray
Methods inherited from interface javafx.beans.Observable
addListener, removeListener
Methods inherited from interface javafx.collections.ObservableList
addAll, addListener, filtered, remove, removeAll, removeListener, retainAll, setAll, setAll, sorted, sorted
-
Property Details
-
comparator
The comparator that denotes the order of this SortedList. Null for unordered SortedList.- See Also:
getComparator()
,setComparator(Comparator)
-
-
Constructor Details
-
SortedList
Creates a new SortedList wrapped around the source list. The source list will be sorted using the comparator provided. If null is provided, the list stays unordered and is equal to the source list.- Parameters:
source
- a list to wrapcomparator
- a comparator to use or null for unordered List
-
SortedList
Constructs a new unordered SortedList wrapper around the source list.- Parameters:
source
- the source list- See Also:
SortedList(javafx.collections.ObservableList, java.util.Comparator)
-
-
Method Details
-
sourceChanged
Description copied from class:TransformationList
Called when a change from the source is triggered.- Specified by:
sourceChanged
in classTransformationList<E,E>
- Parameters:
c
- the change
-
comparatorProperty
The comparator that denotes the order of this SortedList. Null for unordered SortedList.- See Also:
getComparator()
,setComparator(Comparator)
-
getComparator
Gets the value of the property comparator.- Property description:
- The comparator that denotes the order of this SortedList. Null for unordered SortedList.
-
setComparator
Sets the value of the property comparator.- Property description:
- The comparator that denotes the order of this SortedList. Null for unordered SortedList.
-
get
Returns the element at the specified position in this list.- Specified by:
get
in interfaceList<E>
- Specified by:
get
in classAbstractList<E>
- Parameters:
index
- index of the element to return- Returns:
- the element at the specified position in this list
- Throws:
IndexOutOfBoundsException
-
size
public int size()Returns the number of elements in this list.- Specified by:
size
in interfaceCollection<E>
- Specified by:
size
in interfaceList<E>
- Specified by:
size
in classAbstractCollection<E>
- Returns:
- the number of elements in this list
-
getSourceIndex
public int getSourceIndex(int index)Description copied from class:TransformationList
Maps the index of this list's element to an index in the direct source list.- Specified by:
getSourceIndex
in classTransformationList<E,E>
- Parameters:
index
- the index in this list- Returns:
- the index of the element's origin in the source list
- See Also:
TransformationList.getSource()
-
getViewIndex
public int getViewIndex(int index)Description copied from class:TransformationList
Maps the index of the direct source list's element to an index in this list.- Specified by:
getViewIndex
in classTransformationList<E,E>
- Parameters:
index
- the index in the source list- Returns:
- the index of the element in this list if it is contained in this list or negative value otherwise
- See Also:
TransformationList.getSource()
,TransformationList.getSourceIndex(int)
-