javax.swing

Class DefaultListModel

java.lang.Object

javax.swing.AbstractListModel

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

Constructors

Constructor and Description
DefaultListModel()

Method Summary

Methods

Modifier and Type	Method and Description
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())