| com.jgoodies.binding.list.LinkedListModel
| LinkedListModel | | final public class LinkedListModel extends LinkedList implements ObservableList<E>(Code) | | Adds
javax.swing.ListModel capabilities to its superclass
LinkedList, i. e. allows to observe changes in the content and
structure. Useful for lists that are bound to list views, for example
JList, JComboBox and JTable.
author:
Karsten Lentzsch
version:
$Revision: 1.6 $
See Also: ArrayListModel
See Also: java.util.ListIterator<
Parameters:
E - > the type of the list elements |
| Constructor Summary | |
| public | LinkedListModel()
Constructs an empty linked list. | | public | LinkedListModel(Collection<? extends E> c)
Constructs a linked list containing the elements of the specified
collection, in the order they are returned by the collection's
iterator. |
| Method Summary | |
| public void | add(int index, E element)
Inserts the specified element at the specified position in this
list. | | public boolean | add(E e)
Appends the specified element to the end of this list.
Parameters:
e - element to be appended to this list. | | public boolean | addAll(int index, Collection<? extends E> c)
Inserts all of the elements in the specified Collection into this
list, starting at the specified position. | | public void | addFirst(E e)
Inserts the given element at the beginning of this list. | | public void | addLast(E e)
Appends the given element to the end of this list. | | public void | addListDataListener(ListDataListener l)
Adds a listener to the list that's notified each time a change
to the data model occurs. | | public void | clear()
Removes all of the elements from this list. | | public void | fireContentsChanged(int index)
Notifies all registered ListDataListeners that the element
at the specified index has changed. | | public E | getElementAt(int index)
Returns the value at the specified index. | | public ListDataListener[] | getListDataListeners()
Returns an array of all the list data listeners
registered on this LinkedListModel. | | public int | getSize()
Returns the length of the list or 0 if there's no list. | | public ListIterator<E> | listIterator(int index)
Returns a list-iterator of the elements in this list (in proper
sequence), starting at the specified position in the list.
Obeys the general contract of List.listIterator(int).
The list-iterator is fail-fast: if the list is structurally
modified at any time after the Iterator is created, in any way except
through the list-iterator's own remove or add
methods, the list-iterator will throw a
ConcurrentModificationException. | | public E | remove(int index)
Removes the element at the specified position in this list.
Shifts any subsequent elements to the left (subtracts one from their
indices).
Parameters:
index - the index of the element to removed. | | public boolean | remove(Object o)
Removes a single instance of the specified element from this
collection, if it is present (optional operation). | | public E | removeFirst()
Removes and returns the first element from this list. | | public E | removeLast()
Removes and returns the last element from this list. | | public void | removeListDataListener(ListDataListener l)
Removes a listener from the list that's notified each time a
change to the data model occurs. | | protected void | removeRange(int fromIndex, int toIndex)
Removes from this List all of the elements whose index is between
fromIndex, inclusive and toIndex, exclusive. | | public E | set(int index, E element)
Replaces the element at the specified position in this list with
the specified element.
Parameters:
index - index of element to replace.
Parameters:
element - element to be stored at the specified position. |
| LinkedListModel | | public LinkedListModel()(Code) | | Constructs an empty linked list.
|
| LinkedListModel | | public LinkedListModel(Collection<? extends E> c)(Code) | | Constructs a linked list containing the elements of the specified
collection, in the order they are returned by the collection's
iterator.
Parameters:
c - the collection whose elements are to be placed into this list.
throws:
NullPointerException - if the specified collection isnull |
| add | | public void add(int index, E element)(Code) | | Inserts the specified element at the specified position in this
list. Shifts the element currently at that position (if any) and
any subsequent elements to the right (adds one to their indices).
Parameters:
index - index at which the specified element is to be inserted.
Parameters:
element - element to be inserted.
throws:
IndexOutOfBoundsException - if index is out of range(index < 0 || index > size()). |
| add | | public boolean add(E e)(Code) | | Appends the specified element to the end of this list.
Parameters:
e - element to be appended to this list. true (as per the general contract of Collection.add). |
| addAll | | public boolean addAll(int index, Collection<? extends E> c)(Code) | | Inserts all of the elements in the specified Collection into this
list, starting at the specified position. Shifts the element
currently at that position (if any) and any subsequent elements to
the right (increases their indices). The new elements will appear
in the list in the order that they are returned by the
specified Collection's iterator.
Parameters:
index - index at which to insert first elementfrom the specified collection.
Parameters:
c - elements to be inserted into this list. true if this list changed as a result of the call.
throws:
IndexOutOfBoundsException - if index out of range(index < 0 || index > size()).
throws:
NullPointerException - if the specified Collection is null. |
| addFirst | | public void addFirst(E e)(Code) | | Inserts the given element at the beginning of this list.
Parameters:
e - the element to be inserted at the beginning of this list. |
| addLast | | public void addLast(E e)(Code) | | Appends the given element to the end of this list. (Identical in
function to the add method; included only for consistency.)
Parameters:
e - the element to be inserted at the end of this list. |
| addListDataListener | | public void addListDataListener(ListDataListener l)(Code) | | Adds a listener to the list that's notified each time a change
to the data model occurs.
Parameters:
l - the ListDataListener to be added |
| clear | | public void clear()(Code) | | Removes all of the elements from this list. The list will
be empty after this call returns.
|
| fireContentsChanged | | public void fireContentsChanged(int index)(Code) | | Notifies all registered ListDataListeners that the element
at the specified index has changed. Useful if there's a content change
without any structural change.
This method must be called after the element of the list changes.
Parameters:
index - the index of the element that has changed
See Also: EventListenerList |
| getElementAt | | public E getElementAt(int index)(Code) | | Returns the value at the specified index.
Parameters:
index - the requested index the value at index |
| getSize | | public int getSize()(Code) | | Returns the length of the list or 0 if there's no list.
the length of the list or 0 if there's no list |
| listIterator | | public ListIterator<E> listIterator(int index)(Code) | | Returns a list-iterator of the elements in this list (in proper
sequence), starting at the specified position in the list.
Obeys the general contract of List.listIterator(int).
The list-iterator is fail-fast: if the list is structurally
modified at any time after the Iterator is created, in any way except
through the list-iterator's own remove or add
methods, the list-iterator will throw a
ConcurrentModificationException. Thus, in the face of
concurrent modification, the iterator fails quickly and cleanly, rather
than risking arbitrary, non-deterministic behavior at an undetermined
time in the future.
Parameters:
index - index of first element to be returned from thelist-iterator (by a call to next). a ListIterator of the elements in this list (in propersequence), starting at the specified position in the list.
throws:
IndexOutOfBoundsException - if index is out of range(index < 0 || index > size()).
See Also: java.util.List.listIterator(int) |
| remove | | public E remove(int index)(Code) | | Removes the element at the specified position in this list.
Shifts any subsequent elements to the left (subtracts one from their
indices).
Parameters:
index - the index of the element to removed. the element that was removed from the list.
throws:
IndexOutOfBoundsException - if index out of range(index < 0 || index >= size()). |
| remove | | public boolean remove(Object o)(Code) | | Removes a single instance of the specified element from this
collection, if it is present (optional operation). More formally,
removes an element e such that (o==null ? e==null :
o.equals(e)), if the collection contains one or more such
elements. Returns true if the collection contained the
specified element (or equivalently, if the collection changed as a
result of the call).
This implementation iterates over the collection looking for the
specified element. If it finds the element, it removes the element
from the collection using the iterator's remove method.
Note that this implementation throws an
UnsupportedOperationException if the iterator returned by this
collection's iterator method does not implement the remove
method and this collection contains the specified object.
Parameters:
o - element to be removed from this collection, if present. true if the collection contained the specifiedelement. |
| removeFirst | | public E removeFirst()(Code) | | Removes and returns the first element from this list.
the first element from this list.
throws:
java.util.NoSuchElementException - if this list is empty. |
| removeListDataListener | | public void removeListDataListener(ListDataListener l)(Code) | | Removes a listener from the list that's notified each time a
change to the data model occurs.
Parameters:
l - the ListDataListener to be removed |
| removeRange | | protected void removeRange(int fromIndex, int toIndex)(Code) | | Removes from this List all of the elements whose index is between
fromIndex, inclusive and toIndex, exclusive. Shifts any succeeding
elements to the left (reduces their index).
This call shortens the list by (toIndex - fromIndex) elements.
(If toIndex==fromIndex, this operation has no effect.)
Parameters:
fromIndex - index of first element to be removed.
Parameters:
toIndex - index after last element to be removed. |
| set | | public E set(int index, E element)(Code) | | Replaces the element at the specified position in this list with
the specified element.
Parameters:
index - index of element to replace.
Parameters:
element - element to be stored at the specified position. the element previously at the specified position.
throws:
IndexOutOfBoundsException - if index out of range(index < 0 || index >= size()). |
|
|