Java(TM) 2 Platform, Standard Edition, v1.2.2 API Specification: Class DefaultListModel - JDK 5 Documentation v1.2.2, Java 2 SDK 英文文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Standard Edition

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.swing
Class DefaultListModel

java.lang.Object
  |
  +--javax.swing.AbstractListModel
        |
        +--javax.swing.DefaultListModel

public class DefaultListModel
extends AbstractListModel

This class implements the java.util.Vector API and notifies the ListDataListeners 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. A future release of Swing will provide support for long term persistence.

See Also:: Serialized Form

Fields inherited from class javax.swing.AbstractListModel

listenerList

Constructor Summary

DefaultListModel()


Method Summary

void add(int index, Object element)
          Inserts the specified element at the specified position in this list.

void addElement(Object obj)
          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(Object elem)
          Tests if the specified object is a component in this list.

void copyInto(Object[] anArray)
          Copies the components of this list into the specified array.

Object elementAt(int index)
          Returns the component at the specified index.

Enumeration elements()
          Returns an enumeration of the components of this list.

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.

Object firstElement()
          Returns the first component of this list.

Object get(int index)
          Returns the element at the specified position in this list.

Object getElementAt(int index)
          Returns the component at the specified index.

int getSize()
          Returns the number of components in this list.

int indexOf(Object elem)
          Searches for the first occurence of the given argument.

int indexOf(Object elem, int index)
          Searches for the first occurence of the given argument, beginning the search at index.

void insertElementAt(Object obj, int index)
          Inserts the specified object as a component in this list at the specified index.

boolean isEmpty()
          Tests if this list has no components.

Object lastElement()
          Returns the last component of the list.

int lastIndexOf(Object elem)
          Returns the index of the last occurrence of the specified object in this list.

int lastIndexOf(Object elem, int index)
          Searches backwards for the specified object, starting from the specified index, and returns an index to it.

Object remove(int index)
          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(Object obj)
          Removes the first (lowest-indexed) occurrence of the argument from this list.

void removeElementAt(int index)
          Deletes the component at the specified index.

void removeRange(int fromIndex, int toIndex)
          Deletes the components at the specified range of indexes.

Object set(int index, Object element)
          Replaces the element at the specified position in this list with the specified element.

void setElementAt(Object obj, int index)
          Sets the component at the specified index of this list to be the specified object.

void setSize(int newSize)
          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.

Methods inherited from class javax.swing.AbstractListModel

addListDataListener, fireContentsChanged, fireIntervalAdded, fireIntervalRemoved, 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

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 Object 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 not less than the current size of this list. given.
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 if this list has no 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 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 if 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 occurence of the given argument.

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 occurence of the given argument, beginning the search at index.

Parameters:: elem - an object.; index - the index to start searching from.
Returns:: the index of the first occurrence of the object argument in this list at position index or later in the list; returns -1 if the object is not found.
See Also:: Vector.indexOf(Object,int)

lastIndexOf

public int lastIndexOf(Object elem)

Returns the index of the last occurrence of the specified object in this list.

Parameters:: elem - the desired component.
Returns:: the index of the last occurrence of the specified object in this 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 the specified object, 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 specified object in this list at position less than index in the list; -1 if the object is not found.
See Also:: Vector.lastIndexOf(Object,int)

elementAt

public Object 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 Object 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 Object 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(Object obj,
                         int index)

Sets the component at the specified index of this list to be the specified object. 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:: obj - 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(Object obj,
                            int index)

Inserts the specified object 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:: obj - 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(Object obj)

Adds the specified component to the end of this list.

Parameters:: obj - 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.

Throws an ArrayStoreException if the runtime type of the array a is not a supertype of the runtime type of every element in this list.

Parameters:: a - the array into which the elements of the list are to be stored, if it is big enough; otherwise, a new array of the same runtime type is allocated for this purpose.
Returns:: an array containing the elements of the list.
See Also:: Vector.toArray()

get

public Object 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 Object set(int index,
                  Object 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,
                Object 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 Object 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.

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)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Standard Edition

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
Java, Java 2D, and JDBC are a trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1999 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.

Method Summary
`void`	`add(int index, Object element)` Inserts the specified element at the specified position in this list.
`void`	`addElement(Object obj)` 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(Object elem)` Tests if the specified object is a component in this list.
`void`	`copyInto(Object[] anArray)` Copies the components of this list into the specified array.
`Object`	`elementAt(int index)` Returns the component at the specified index.
`Enumeration`	`elements()` Returns an enumeration of the components of this list.
`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.
`Object`	`firstElement()` Returns the first component of this list.
`Object`	`get(int index)` Returns the element at the specified position in this list.
`Object`	`getElementAt(int index)` Returns the component at the specified index.
`int`	`getSize()` Returns the number of components in this list.
`int`	`indexOf(Object elem)` Searches for the first occurence of the given argument.
`int`	`indexOf(Object elem, int index)` Searches for the first occurence of the given argument, beginning the search at `index`.
`void`	`insertElementAt(Object obj, int index)` Inserts the specified object as a component in this list at the specified `index`.
`boolean`	`isEmpty()` Tests if this list has no components.
`Object`	`lastElement()` Returns the last component of the list.
`int`	`lastIndexOf(Object elem)` Returns the index of the last occurrence of the specified object in this list.
`int`	`lastIndexOf(Object elem, int index)` Searches backwards for the specified object, starting from the specified index, and returns an index to it.
`Object`	`remove(int index)` 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(Object obj)` Removes the first (lowest-indexed) occurrence of the argument from this list.
`void`	`removeElementAt(int index)` Deletes the component at the specified index.
`void`	`removeRange(int fromIndex, int toIndex)` Deletes the components at the specified range of indexes.
`Object`	`set(int index, Object element)` Replaces the element at the specified position in this list with the specified element.
`void`	`setElementAt(Object obj, int index)` Sets the component at the specified `index` of this list to be the specified object.
`void`	`setSize(int newSize)` 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.

Java(TM) 2 Platform, Standard Edition, v1.2.2 API Specification: Class DefaultListModel - JDK 5 Documentation v1.2.2, Java 2 SDK 英文文档

javax.swing Class DefaultListModel

DefaultListModel

getSize

getElementAt

copyInto

trimToSize

ensureCapacity

setSize

capacity

size

isEmpty

elements

contains

indexOf

indexOf

lastIndexOf

lastIndexOf

elementAt

firstElement

lastElement

setElementAt

removeElementAt

insertElementAt

addElement

removeElement

removeAllElements

toString

toArray

get

set

add

remove

clear

removeRange

javax.swing
Class DefaultListModel