E
- the type of the elements of this modelSerializable
, ListModel<E>
public class DefaultListModel<E> extends AbstractListModel<E>
java.util.Vector
API, in that it implements the 1.1.x version of java.util.Vector
, has no collection class support, and notifies the ListDataListener
s when changes occur. Presently it delegates to a Vector
, in a future release it will be a real Collection implementation. Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans has been added to the java.beans
package. Please see XMLEncoder
.
listenerList
Constructor | Description |
---|---|
DefaultListModel() |
Constructs a DefaultListModel . |
Modifier and Type | Method | Description |
---|---|---|
void |
add |
Inserts the specified element at the specified position in this list. |
void |
addAll |
Adds all of the elements present in the collection, starting from the specified index. |
void |
addAll |
Adds all of the elements present in the collection to the list. |
void |
addElement |
Adds the specified component to the end of this list. |
int |
capacity() |
Returns the current capacity of this list. |
void |
clear() |
Removes all of the elements from this list. |
boolean |
contains |
Tests whether the specified object is a component in this list. |
void |
copyInto |
Copies the components of this list into the specified array. |
E |
elementAt |
Returns the component at the specified index. |
Enumeration |
elements() |
Returns an enumeration of the components of this list. |
void |
ensureCapacity |
Increases the capacity of this list, if necessary, to ensure that it can hold at least the number of components specified by the minimum capacity argument. |
E |
firstElement() |
Returns the first component of this list. |
E |
get |
Returns the element at the specified position in this list. |
E |
getElementAt |
Returns the component at the specified index. |
int |
getSize() |
Returns the number of components in this list. |
int |
indexOf |
Searches for the first occurrence of elem . |
int |
indexOf |
Searches for the first occurrence of elem , beginning the search at index . |
void |
insertElementAt |
Inserts the specified element as a component in this list at the specified index . |
boolean |
isEmpty() |
Tests whether this list has any components. |
E |
lastElement() |
Returns the last component of the list. |
int |
lastIndexOf |
Returns the index of the last occurrence of elem . |
int |
lastIndexOf |
Searches backwards for elem , starting from the specified index, and returns an index to it. |
E |
remove |
Removes the element at the specified position in this list. |
void |
removeAllElements() |
Removes all components from this list and sets its size to zero. |
boolean |
removeElement |
Removes the first (lowest-indexed) occurrence of the argument from this list. |
void |
removeElementAt |
Deletes the component at the specified index. |
void |
removeRange |
Deletes the components at the specified range of indexes. |
E |
set |
Replaces the element at the specified position in this list with the specified element. |
void |
setElementAt |
Sets the component at the specified index of this list to be the specified element. |
void |
setSize |
Sets the size of this list. |
int |
size() |
Returns the number of components in this list. |
Object[] |
toArray() |
Returns an array containing all of the elements in this list in the correct order. |
String |
toString() |
Returns a string that displays and identifies this object's properties. |
void |
trimToSize() |
Trims the capacity of this list to be the list's current size. |
addListDataListener, fireContentsChanged, fireIntervalAdded, fireIntervalRemoved, getListDataListeners, getListeners, removeListDataListener
public DefaultListModel()
DefaultListModel
.public int getSize()
This method is identical to size
, which implements the List
interface defined in the 1.2 Collections framework. This method exists in conjunction with setSize
so that size
is identifiable as a JavaBean property.
public E getElementAt(int index)
Note: Although this method is not deprecated, the preferred method to use isget(int)
, which implements theList
interface defined in the 1.2 Collections framework.
index
- an index into this listArrayIndexOutOfBoundsException
- if the index
is negative or greater than the current size of this listpublic void copyInto(Object[] anArray)
IndexOutOfBoundsException
is thrown.anArray
- the array into which the components get copiedpublic void trimToSize()
public void ensureCapacity(int minCapacity)
minCapacity
- the desired minimum capacitypublic void setSize(int newSize)
newSize
- the new size of this listpublic int capacity()
public int size()
public boolean isEmpty()
true
if and only if this list has no components, that is, its size is zero; false
otherwisepublic Enumeration<E> elements()
public boolean contains(Object elem)
elem
- an objecttrue
if the specified object is the same as a component in this listpublic int indexOf(Object elem)
elem
.elem
- an object-1
if the object is not foundpublic int indexOf(Object elem, int index)
elem
, beginning the search at index
.elem
- the desired componentindex
- the index from which to begin searchingelem
is found after index
; returns -1
if the elem
is not found in the listpublic int lastIndexOf(Object elem)
elem
.elem
- the desired componentelem
in the list; returns elem
if the object is not foundpublic int lastIndexOf(Object elem, int index)
elem
, starting from the specified index, and returns an index to it.elem
- the desired componentindex
- the index to start searching fromelem
in this list at position less than index
; returns -1
if the object is not foundpublic E elementAt(int index)
Note: Although this method is not deprecated, the preferred method to use isget(int)
, which implements theList
interface defined in the 1.2 Collections framework.
index
- an index into this listArrayIndexOutOfBoundsException
- if the index is negative or not less than the size of the listpublic E firstElement()
NoSuchElementException
- if this vector has no componentspublic E lastElement()
NoSuchElementException
- if this vector has no componentspublic void setElementAt(E element, int index)
index
of this list to be the specified element. The previous component at that position is discarded. Note: Although this method is not deprecated, the preferred method to use isset(int,Object)
, which implements theList
interface defined in the 1.2 Collections framework.
element
- what the component is to be set toindex
- the specified indexArrayIndexOutOfBoundsException
- if the index is invalidpublic void removeElementAt(int index)
Note: Although this method is not deprecated, the preferred method to use isremove(int)
, which implements theList
interface defined in the 1.2 Collections framework.
index
- the index of the object to removeArrayIndexOutOfBoundsException
- if the index is invalidpublic void insertElementAt(E element, int index)
index
. Note: Although this method is not deprecated, the preferred method to use isadd(int,Object)
, which implements theList
interface defined in the 1.2 Collections framework.
element
- the component to insertindex
- where to insert the new componentArrayIndexOutOfBoundsException
- if the index was invalidpublic void addElement(E element)
element
- the component to be addedpublic boolean removeElement(Object obj)
obj
- the component to be removedtrue
if the argument was a component of this list; false
otherwisepublic void removeAllElements()
Note: Although this method is not deprecated, the preferred method to use isclear
, which implements theList
interface defined in the 1.2 Collections framework.
public String toString()
public Object[] toArray()
public E get(int index)
index
- index of element to returnArrayIndexOutOfBoundsException
- if the index is out of range (index < 0 || index >= size()
)public E set(int index, E element)
index
- index of element to replaceelement
- element to be stored at the specified positionArrayIndexOutOfBoundsException
- if the index is out of range (index < 0 || index >= size()
)public void add(int index, E element)
index
- index at which the specified element is to be insertedelement
- element to be insertedArrayIndexOutOfBoundsException
- if the index is out of range (index < 0 || index > size()
)public E remove(int index)
index
- the index of the element to removedArrayIndexOutOfBoundsException
- if the index is out of range (index < 0 || index >= size()
)public void clear()
public void removeRange(int fromIndex, int toIndex)
fromIndex
- the index of the lower end of the rangetoIndex
- the index of the upper end of the rangeArrayIndexOutOfBoundsException
- if the index was invalidIllegalArgumentException
- if fromIndex > toIndex
public void addAll(Collection<? extends E> c)
c
- the collection which contains the elements to addNullPointerException
- if c
is nullpublic void addAll(int index, Collection<? extends E> c)
index
- index at which to insert the first element from the specified collectionc
- the collection which contains the elements to addArrayIndexOutOfBoundsException
- if index
does not fall within the range of number of elements currently heldNullPointerException
- if c
is null
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/DefaultListModel.html