Package javafx.collections

Interface ObservableList<E>

Type Parameters:
E - the list element type
All Superinterfaces:
Collection<E>, Iterable<E>, List<E>, Observable
All Known Subinterfaces:
ObservableListValue<E>, WritableListValue<E>
All Known Implementing Classes:
FilteredList, ImmutableObservableList, ListExpression, ListProperty, ListPropertyBase, ModifiableObservableListBase, ObservableListBase, ObservableListWrapper, ObservableSequentialListWrapper, ReadOnlyListProperty, SimpleListProperty, SortedList, TrackableObservableList, TransformationList, VetoableListDecorator
public interface ObservableList<E> extends List<E>, Observable
A list that allows listeners to track changes when they occur.
Since:
JavaFX 2.0
See Also:

  • Method Details

    • addListener

      void addListener(ListChangeListener<? super E> listener)
      Add a listener to this observable list.
      Parameters:
      listener - the listener for listening to the list changes

    • removeListener

      void removeListener(ListChangeListener<? super E> listener)
      Tries to removed a listener from this observable list. If the listener is not attached to this list, nothing happens.
      Parameters:
      listener - a listener to remove

    • addAll

      boolean addAll(E... elements)
      A convenient method for var-arg adding of elements.
      Parameters:
      elements - the elements to add
      Returns:
      true (as specified by Collection.add(E))

    • setAll

      boolean setAll(E... elements)
      Clears the ObservableList and add all the elements passed as var-args.
      Parameters:
      elements - the elements to set
      Returns:
      true (as specified by Collection.add(E))
      Throws:
      NullPointerException - if the specified arguments contain one or more null elements

    • setAll

      boolean setAll(Collection<? extends E> col)
      Clears the ObservableList and add all elements from the collection.
      Parameters:
      col - the collection with elements that will be added to this observableArrayList
      Returns:
      true (as specified by Collection.add(E))
      Throws:
      NullPointerException - if the specified collection contains one or more null elements

    • removeAll

      boolean removeAll(E... elements)
      A convenient method for var-arg usage of removaAll method.
      Parameters:
      elements - the elements to be removed
      Returns:
      true if list changed as a result of this call

    • retainAll

      boolean retainAll(E... elements)
      A convenient method for var-arg usage of retain method.
      Parameters:
      elements - the elements to be retained
      Returns:
      true if list changed as a result of this call

    • remove

      void remove(int from, int to)
      Basically a shortcut to sublist(from, to).clear() As this is a common operation, ObservableList has this method for convenient usage.
      Parameters:
      from - the start of the range to remove (inclusive)
      to - the end of the range to remove (exclusive)
      Throws:
      IndexOutOfBoundsException - if an illegal range is provided

    • filtered

      default FilteredList<E> filtered(Predicate<E> predicate)
      Creates a FilteredList wrapper of this list using the specified predicate.
      Parameters:
      predicate - the predicate to use
      Returns:
      new FilteredList
      Since:
      JavaFX 8.0

    • sorted

      default SortedList<E> sorted(Comparator<E> comparator)
      Creates a SortedList wrapper of this list using the specified comparator.
      Parameters:
      comparator - the comparator to use or null for unordered List
      Returns:
      new SortedList
      Since:
      JavaFX 8.0