javafx.collections

Interface ObservableList<E>

Type Parameters:

E - the list element type

All Superinterfaces:

java.util.Collection<E>, java.lang.Iterable<E>, java.util.List<E>, Observable

All Known Subinterfaces:

ObservableListValue<E>, WritableListValue<E>

All Known Implementing Classes:

ListBinding, ListExpression, ListProperty, ListPropertyBase, ReadOnlyListProperty, ReadOnlyListPropertyBase, ReadOnlyListWrapper, SimpleListProperty

public interface ObservableList<E>
extends java.util.List<E>, Observable

A list that allows listeners to track changes when they occur.

See Also:

ListChangeListener, ListChangeListener.Change

Method Summary

Methods

Modifier and Type	Method and Description
boolean	addAll(E... elements) A convenient method for var-arg adding of elements.
void	addListener(ListChangeListener<? super E> listener) Add a listener to this observable list.
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.
boolean	removeAll(E... elements) A convenient method for var-arg usage of removaAll method.
void	removeListener(ListChangeListener<? super E> listener) Tries to removed a listener from this observable list.
boolean	retainAll(E... elements) A convenient method for var-arg usage of retain method.
boolean	setAll(java.util.Collection<? extends E> col) Clears the ObservableList and add all elements from the collection.
boolean	setAll(E... elements) Clears the ObservableList and add all the elements passed as var-args.

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, retainAll, set, size, subList, toArray, toArray

Methods inherited from interface javafx.beans.Observable

addListener, removeListener

Method Detail

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:

java.lang.NullPointerException - if the specified arguments contain one or more null elements

setAll

boolean setAll(java.util.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:

java.lang.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:

java.lang.IndexOutOfBoundsException - if an illegal range is provided