Class DefaultListModel<E>

Constructor Detail

• DefaultListModel

  public DefaultListModel()

Method Detail

• getSize

  public int getSize()

  Returns the number of components in this list.

  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.

  Returns:

  the number of components in this list

  See Also:

  size()

• getElementAt

  public E getElementAt(int index)

  Returns the component at the specified index.

  Note: Although this method is not deprecated, the preferred method to use is get(int), which implements the List interface defined in the 1.2 Collections framework.

  Parameters:

  index - an index into this list

  Returns:

  the component at the specified index

  Throws:

  ArrayIndexOutOfBoundsException - if the index is negative or greater than the current size of this list

  See Also:

  get(int)

• copyInto

  public void copyInto(Object[] anArray)

  Copies the components of this list into the specified array. The array must be big enough to hold all the objects in this list, else an IndexOutOfBoundsException is thrown.

  Parameters:

  anArray - the array into which the components get copied

  See Also:

  Vector.copyInto(Object[])

• trimToSize

  public void trimToSize()

  Trims the capacity of this list to be the list's current size.

  See Also:

  Vector.trimToSize()

• ensureCapacity

  public void ensureCapacity(int minCapacity)

  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.

  Parameters:

  minCapacity - the desired minimum capacity

  See Also:

  Vector.ensureCapacity(int)

• setSize

  public void setSize(int newSize)

  Sets the size of this list.

  Parameters:

  newSize - the new size of this list

  See Also:

  Vector.setSize(int)

• capacity

  public int capacity()

  Returns the current capacity of this list.

  Returns:

  the current capacity

  See Also:

  Vector.capacity()

• size

  public int size()

  Returns the number of components in this list.

  Returns:

  the number of components in this list

  See Also:

  Vector.size()

• isEmpty

  public boolean isEmpty()

  Tests whether this list has any components.

  Returns:

  true if and only if this list has no components, that is, its size is zero; false otherwise

  See Also:

  Vector.isEmpty()

• elements

  public Enumeration<E> elements()

  Returns an enumeration of the components of this list.

  Returns:

  an enumeration of the components of this list

  See Also:

  Vector.elements()

• contains

  public boolean contains(Object elem)

  Tests whether the specified object is a component in this list.

  Parameters:

  elem - an object

  Returns:

  true if the specified object is the same as a component in this list

  See Also:

  Vector.contains(Object)

• indexOf

  public int indexOf(Object elem)

  Searches for the first occurrence of elem.

  Parameters:

  elem - an object

  Returns:

  the index of the first occurrence of the argument in this list; returns -1 if the object is not found

  See Also:

  Vector.indexOf(Object)

• indexOf

  public int indexOf(Object elem,
            int index)

  Searches for the first occurrence of elem, beginning the search at index.

  Parameters:

  elem - an desired component

  index - the index from which to begin searching

  Returns:

  the index where the first occurrence of elem is found after index; returns -1 if the elem is not found in the list

  See Also:

  Vector.indexOf(Object,int)

• lastIndexOf

  public int lastIndexOf(Object elem)

  Returns the index of the last occurrence of elem.

  Parameters:

  elem - the desired component

  Returns:

  the index of the last occurrence of elem in the list; returns -1 if the object is not found

  See Also:

  Vector.lastIndexOf(Object)

• lastIndexOf

  public int lastIndexOf(Object elem,
                int index)

  Searches backwards for elem, starting from the specified index, and returns an index to it.

  Parameters:

  elem - the desired component

  index - the index to start searching from

  Returns:

  the index of the last occurrence of the elem in this list at position less than index; returns -1 if the object is not found

  See Also:

  Vector.lastIndexOf(Object,int)

• elementAt

  public E elementAt(int index)

  Returns the component at the specified index. Throws an ArrayIndexOutOfBoundsException if the index is negative or not less than the size of the list.

  Note: Although this method is not deprecated, the preferred method to use is get(int), which implements the List interface defined in the 1.2 Collections framework.

  Parameters:

  index - an index into this list

  Returns:

  the component at the specified index

  See Also:

  get(int), Vector.elementAt(int)

• firstElement

  public E firstElement()

  Returns the first component of this list. Throws a NoSuchElementException if this vector has no components.

  Returns:

  the first component of this list

  See Also:

  Vector.firstElement()

• lastElement

  public E lastElement()

  Returns the last component of the list. Throws a NoSuchElementException if this vector has no components.

  Returns:

  the last component of the list

  See Also:

  Vector.lastElement()

• setElementAt

  public void setElementAt(E element,
                  int index)

  Sets the component at the specified index of this list to be the specified element. The previous component at that position is discarded.

  Throws an ArrayIndexOutOfBoundsException if the index is invalid.

  Note: Although this method is not deprecated, the preferred method to use is set(int,Object), which implements the List interface defined in the 1.2 Collections framework.

  Parameters:

  element - what the component is to be set to

  index - the specified index

  See Also:

  set(int,Object), Vector.setElementAt(Object,int)

• removeElementAt

  public void removeElementAt(int index)

  Deletes the component at the specified index.

  Throws an ArrayIndexOutOfBoundsException if the index is invalid.

  Note: Although this method is not deprecated, the preferred method to use is remove(int), which implements the List interface defined in the 1.2 Collections framework.

  Parameters:

  index - the index of the object to remove

  See Also:

  remove(int), Vector.removeElementAt(int)

• insertElementAt

  public void insertElementAt(E element,
                     int index)

  Inserts the specified element as a component in this list at the specified index.

  Throws an ArrayIndexOutOfBoundsException if the index is invalid.

  Note: Although this method is not deprecated, the preferred method to use is add(int,Object), which implements the List interface defined in the 1.2 Collections framework.

  Parameters:

  element - the component to insert

  index - where to insert the new component

  Throws:

  ArrayIndexOutOfBoundsException - if the index was invalid

  See Also:

  add(int,Object), Vector.insertElementAt(Object,int)

• addElement

  public void addElement(E element)

  Adds the specified component to the end of this list.

  Parameters:

  element - the component to be added

  See Also:

  Vector.addElement(Object)

• removeElement

  public boolean removeElement(Object obj)

  Removes the first (lowest-indexed) occurrence of the argument from this list.

  Parameters:

  obj - the component to be removed

  Returns:

  true if the argument was a component of this list; false otherwise

  See Also:

  Vector.removeElement(Object)

• removeAllElements

  public void removeAllElements()

  Removes all components from this list and sets its size to zero.

  Note: Although this method is not deprecated, the preferred method to use is clear, which implements the List interface defined in the 1.2 Collections framework.

  See Also:

  clear(), Vector.removeAllElements()

• toString

  public String toString()

  Returns a string that displays and identifies this object's properties.

  Overrides:

  toString in class Object

  Returns:

  a String representation of this object

• toArray

  public Object[] toArray()

  Returns an array containing all of the elements in this list in the correct order.

  Returns:

  an array containing the elements of the list

  See Also:

  Vector.toArray()

• get

  public E get(int index)

  Returns the element at the specified position in this list.

  Throws an ArrayIndexOutOfBoundsException if the index is out of range (index < 0 || index >= size()).

  Parameters:

  index - index of element to return

• set

  public E set(int index,
      E element)

  Replaces the element at the specified position in this list with the specified element.

  Throws an ArrayIndexOutOfBoundsException if the index is out of range (index < 0 || index >= size()).

  Parameters:

  index - index of element to replace

  element - element to be stored at the specified position

  Returns:

  the element previously at the specified position

• add

  public void add(int index,
         E element)

  Inserts the specified element at the specified position in this list.

  Throws an ArrayIndexOutOfBoundsException if the index is out of range (index < 0 || index > size()).

  Parameters:

  index - index at which the specified element is to be inserted

  element - element to be inserted

• remove

  public E remove(int index)

  Removes the element at the specified position in this list. Returns the element that was removed from the list.

  Throws an ArrayIndexOutOfBoundsException if the index is out of range (index < 0 || index >= size()).

  Parameters:

  index - the index of the element to removed

  Returns:

  the element previously at the specified position

• clear

  public void clear()

  Removes all of the elements from this list. The list will be empty after this call returns (unless it throws an exception).

• removeRange

  public void removeRange(int fromIndex,
                 int toIndex)

  Deletes the components at the specified range of indexes. The removal is inclusive, so specifying a range of (1,5) removes the component at index 1 and the component at index 5, as well as all components in between.

  Throws an ArrayIndexOutOfBoundsException if the index was invalid. Throws an IllegalArgumentException if fromIndex > toIndex.

  Parameters:

  fromIndex - the index of the lower end of the range

  toIndex - the index of the upper end of the range

  See Also:

  remove(int)