javax.swing
Class DefaultListModel

java.lang.Object
  extended by javax.swing.AbstractListModel
      extended by javax.swing.DefaultListModel
All Implemented Interfaces:
Serializable, ListModel

public class DefaultListModel
extends AbstractListModel

The default implementation of AbstractListModel, used by JList and similar objects as the model of a list of values. The implementation is based on an underlying Vector.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class javax.swing.AbstractListModel
listenerList
 
Constructor Summary
DefaultListModel()
           
 
Method Summary
 void add(int index, Object element)
          Inserts an element at a particular index in the list.
 void addElement(Object element)
          Inserts an element at the end of the list.
 int capacity()
          Gets the capacity of the list.
 void clear()
          Erases all the elements of the list, setting the list's size to 0.
 boolean contains(Object element)
          Determines whether a particular element is a member of the list.
 void copyInto(Object[] array)
          Copies the list into a provided array.
 Object elementAt(int index)
          Gets an element of the list at the provided index.
 Enumeration<?> elements()
          Returns an Enumeration over the elements of the list.
 void ensureCapacity(int size)
          Ensures that the list's capacity is at least equal to size.
 Object firstElement()
          Gets the first element in the list.
 Object get(int index)
          Gets the list element at a particular index.
 Object getElementAt(int index)
          Gets the list element at a particular index.
 int getSize()
          Gets the size of the list.
 int indexOf(Object element)
          Gets the first index of a particular element in the list.
 int indexOf(Object element, int startIndex)
          Gets the first index of a particular element in a list which occurs at or after a particular index.
 void insertElementAt(Object element, int index)
          Inserts an element at a particular index in the list.
 boolean isEmpty()
          Determines whether the list is empty.
 Object lastElement()
          Gets the last element in the list.
 int lastIndexOf(Object element)
          Gets the last index of a particular element in the list.
 int lastIndexOf(Object element, int endIndex)
          Gets the last index of a particular element in a list which occurs at or before a particular index.
 Object remove(int index)
          Removes the element at a particular index from the list.
 void removeAllElements()
          Remove all elements in the list.
 boolean removeElement(Object element)
          Removes the first occurrence of a particular element in the list.
 void removeElementAt(int index)
          Removes the element at a particular index from the list.
 void removeRange(int startIndex, int endIndex)
          Remove all elements between startIndex and endIndex inclusive.
 Object set(int index, Object element)
          Sets the list element at a particular index.
 void setElementAt(Object element, int index)
          Sets the list element at a particular index.
 void setSize(int size)
          Sets the size of the list to a particular value.
 int size()
          Gets the number of elements in the list.
 Object[] toArray()
          Gets an array containing the elements of the list.
 String toString()
          Convert the list to a string representation.
 void trimToSize()
          Sets the capacity of the list to be equal to its size.
 
Methods inherited from class javax.swing.AbstractListModel
addListDataListener, fireContentsChanged, fireIntervalAdded, fireIntervalRemoved, getListDataListeners, getListeners, removeListDataListener
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DefaultListModel

public DefaultListModel()
Method Detail

elementAt

public Object elementAt(int index)
Gets an element of the list at the provided index.

Parameters:
index - The index of the element to get
Returns:
The object at the given index
Throws:
ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

toString

public String toString()
Convert the list to a string representation.

Overrides:
toString in class Object
Returns:
A string representation of the list
See Also:
Object.getClass(), Object.hashCode(), Class.getName(), Integer.toHexString(int)

indexOf

public int indexOf(Object element)
Gets the first index of a particular element in the list.

Parameters:
element - The element to search for
Returns:
The first index in the list at which an object obj exists such that obj.equals(element) is true; if no such object exists, the method returns -1

indexOf

public int indexOf(Object element,
                   int startIndex)
Gets the first index of a particular element in a list which occurs at or after a particular index.

Parameters:
element - The element to search for
startIndex - The index to begin searching at
Returns:
The first index in the list, greater than or equal to startIndex, at which an object obj exists such that obj.equals(element) is true; if no such object exists, the method returns -1

lastIndexOf

public int lastIndexOf(Object element)
Gets the last index of a particular element in the list.

Parameters:
element - The element to search for
Returns:
The last index in the list at which an object obj exists such that obj.equals(element) is true; if no such object exists, the method returns -1

lastIndexOf

public int lastIndexOf(Object element,
                       int endIndex)
Gets the last index of a particular element in a list which occurs at or before a particular index.

Parameters:
element - The element to search for
endIndex - The index to finish searching at
Returns:
The last index in the list, less than to or equal to endIndexIndex, at which an object obj exists such that obj.equals(element) is true; if no such object exists, the method returns -1

get

public Object get(int index)
Gets the list element at a particular index.

Parameters:
index - The index to get the list value at
Returns:
The list value at the provided index
Throws:
ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

set

public Object set(int index,
                  Object element)
Sets the list element at a particular index.

Parameters:
index - The list index at which to set a value
element - The value to set at the specified index
Returns:
The value previously held at the specified index
Throws:
ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

add

public void add(int index,
                Object element)
Inserts an element at a particular index in the list. Each element at index i >= index is shifted to position i + 1. If index is equal to size(), this is equivalent to appending an element to the array. Any index greater than size() is illegal.

Parameters:
index - The index to insert the element at
element - The element to insert at the index
Throws:
ArrayIndexOutOfBoundsException - If the provided index is outside the bounds [0, size()]

addElement

public void addElement(Object element)
Inserts an element at the end of the list. This is equivalent to calling list.add(list.size(), element).

Parameters:
element - The element to add to the list

size

public int size()
Gets the number of elements in the list.

Returns:
The number of elements in the list

toArray

public Object[] toArray()
Gets an array containing the elements of the list.

Returns:
An array of the objects in the list, in the order they occur in the list

contains

public boolean contains(Object element)
Determines whether a particular element is a member of the list.

Parameters:
element - The element to search for
Returns:
true if element is a member of the list, otherwise false

copyInto

public void copyInto(Object[] array)
Copies the list into a provided array. The provided array must be at least as large as the list.

Parameters:
array - The array to copy the list into
Throws:
IndexOutOfBoundsException - if the array is too small to hold the elements of the list

clear

public void clear()
Erases all the elements of the list, setting the list's size to 0.


remove

public Object remove(int index)
Removes the element at a particular index from the list.

Parameters:
index - The index of the element to remove
Returns:
The value at the index, which has been removed from the list
Throws:
ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

isEmpty

public boolean isEmpty()
Determines whether the list is empty.

Returns:
true if the list is empty, otherwise false

elements

public Enumeration<?> elements()
Returns an Enumeration over the elements of the list.

Returns:
A new enumeration which iterates over the list

trimToSize

public void trimToSize()
Sets the capacity of the list to be equal to its size. The list's capacity is the number of elements it can hold before it needs to be reallocated. The list's size is the number of elements it currently holds.


ensureCapacity

public void ensureCapacity(int size)
Ensures that the list's capacity is at least equal to size. The list's capacity is the number of elements it can hold before it needs to be reallocated.

Parameters:
size - The capacity to ensure the list can hold

setSize

public void setSize(int size)
Sets the size of the list to a particular value. If the specified size is greater than the current size, the values at the excess list indices are set to null. If the specified size is less than the current size, the excess elements are removed from the list.

Parameters:
size - The new size to set the list to

capacity

public int capacity()
Gets the capacity of the list. The list's capacity is the number of elements it can hold before it needs to be reallocated.

Returns:
The capacity of the list

firstElement

public Object firstElement()
Gets the first element in the list.

Returns:
The first element in the list

lastElement

public Object lastElement()
Gets the last element in the list.

Returns:
The last element in the list

setElementAt

public void setElementAt(Object element,
                         int index)
Sets the list element at a particular index.

Parameters:
element - The value to set at the specified index
index - The list index at which to set a value
Throws:
ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

removeElementAt

public void removeElementAt(int index)
Removes the element at a particular index from the list.

Parameters:
index - The index of the element to remove
Throws:
ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())

insertElementAt

public void insertElementAt(Object element,
                            int index)
Inserts an element at a particular index in the list. Each element at index i >= index is shifted to position i + 1. If index is equal to size(), this is equivalent to appending an element to the array. Any index greater than size() is illegal.

Parameters:
element - The element to insert at the index
index - The index to insert the element at
Throws:
ArrayIndexOutOfBoundsException - If the provided index is outside the bounds [0, size()]

removeElement

public boolean removeElement(Object element)
Removes the first occurrence of a particular element in the list. If the element does not exist in the list, nothing happens.

Parameters:
element - The element to remove
Returns:
true if the element existed in the list (and was removed), false otherwise

removeAllElements

public void removeAllElements()
Remove all elements in the list.


removeRange

public void removeRange(int startIndex,
                        int endIndex)
Remove all elements between startIndex and endIndex inclusive.

Parameters:
startIndex - The first index in the range to remove
endIndex - The last index in the range to remove
Throws:
ArrayIndexOutOfBoundsException - if either index is outside the valid range of indices for this list [0, size())
IllegalArgumentException - if startIndex > endIndex

getSize

public int getSize()
Gets the size of the list.

Returns:
The number of elements currently in the list

getElementAt

public Object getElementAt(int index)
Gets the list element at a particular index.

Parameters:
index - The index to get the list value at
Returns:
The list value at the provided index
Throws:
ArrayIndexOutOfBoundsException - If the provided index is outside the bounds of the list [0, size())