Module javafx.base

Class 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 Details

  • Constructor Details

    • SortedList

      public SortedList​(ObservableList<? extends E> source, Comparator<? super E> comparator)
      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 wrap
      comparator - a comparator to use or null for unordered List
    • SortedList

      public SortedList​(ObservableList<? extends E> source)
      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

      protected void sourceChanged​(ListChangeListener.Change<? extends E> c)
      Description copied from class: TransformationList
      Called when a change from the source is triggered.
      Specified by:
      sourceChanged in class TransformationList<E,​E>
      Parameters:
      c - the change
    • comparatorProperty

      public final ObjectProperty<Comparator<? super E>> comparatorProperty()
      The comparator that denotes the order of this SortedList. Null for unordered SortedList.
      See Also:
      getComparator(), setComparator(Comparator)
    • getComparator

      public final Comparator<? super E> getComparator()
      Gets the value of the property comparator.
      Property description:
      The comparator that denotes the order of this SortedList. Null for unordered SortedList.
    • setComparator

      public final void setComparator​(Comparator<? super E> comparator)
      Sets the value of the property comparator.
      Property description:
      The comparator that denotes the order of this SortedList. Null for unordered SortedList.
    • get

      public E get​(int index)
      Returns the element at the specified position in this list.
      Specified by:
      get in interface List<E>
      Specified by:
      get in class AbstractList<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 interface Collection<E>
      Specified by:
      size in interface List<E>
      Specified by:
      size in class AbstractCollection<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 class TransformationList<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 class TransformationList<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)