Класс DefaultListModel<E>

Этот класс слабо реализует API java.util.Vector, в том смысле, что он реализует версию 1.1.x java.util.Vector, не имеет поддержки коллекций и не уведомляет ListDataListener при изменениях. В настоящее время он делегирует Vector, в будущей версии он будет настоящей реализацией Collection.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, использующими ту же версию Swing. С версии 1.4 поддержка долговременного хранения всех JavaBeans™ была добавлена в пакет java.beans. См. XMLEncoder.

Конструкторы

DefaultListModel

public DefaultListModel()

Методы

getSize

public int getSize()

Возвращает:

количество компонентов в этом списке

См. также:

size()

getElementAt

public E getElementAt(int 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.

Параметры:

index - индекс в этом списке

Возвращает:

компонент по указанному индексу

Исключения:

ArrayIndexOutOfBoundsException - если index отрицательный или больше текущего размера этого списка

См. также:

get(int)

copyInto

public void copyInto(Object[] anArray)

Копирует компоненты этого списка в указанный массив. Массив должен быть достаточно большим, чтобы вместить все объекты в этом списке, иначе будет выброшено исключение IndexOutOfBoundsException.

Параметры:

anArray - массив, в который копируются компоненты

См. также:

Vector.copyInto(Object[])

trimToSize

public void trimToSize()

Уменьшает емкость этого списка до текущего размера списка.

См. также:

Vector.trimToSize()

ensureCapacity

public void ensureCapacity(int minCapacity)

При необходимости увеличивает емкость этого списка, чтобы он мог вместить как минимум количество компонентов, указанное аргументом минимальной емкости.

Параметры:

minCapacity - желаемая минимальная емкость

См. также:

Vector.ensureCapacity(int)

setSize

public void setSize(int newSize)

Устанавливает размер этого списка.

Параметры:

newSize - новый размер этого списка

См. также:

Vector.setSize(int)

capacity

public int capacity()

Возвращает текущую емкость этого списка.

Возвращает:

текущая емкость

См. также:

Vector.capacity()

size

public int size()

Возвращает количество компонентов в этом списке.

Возвращает:

количество компонентов в этом списке

См. также:

Vector.size()

isEmpty

public boolean isEmpty()

Проверяет, содержит ли этот список какие-либо компоненты.

Возвращает:

true если и только если этот список не содержит компонентов, то есть его размер равен нулю; false в противном случае

См. также:

Vector.isEmpty()

elements

public Enumeration<E> elements()

Возвращает перечисление компонентов этого списка.

Возвращает:

перечисление компонентов этого списка

См. также:

Vector.elements()

contains

public boolean contains(Object elem)

Проверяет, является ли указанный объект компонентом в этом списке.

Параметры:

elem - объект

Возвращает:

true если указанный объект совпадает с компонентом в этом списке

См. также:

Vector.contains(Object)

indexOf

public int indexOf(Object elem)

Ищет первое вхождение elem.

Параметры:

elem - объект

Возвращает:

индекс первого вхождения аргумента в этом списке; возвращает -1, если объект не найден

См. также:

Vector.indexOf(Object)

indexOf

public int indexOf(Object elem,
                   int index)

Ищет первое вхождение elem, начиная поиск с index.

Параметры:

elem - желаемый компонент

index - индекс, с которого следует начать поиск

Возвращает:

индекс, где найдено первое вхождение elem после index; возвращает -1, если elem не найден в списке

См. также:

Vector.indexOf(Object,int)

lastIndexOf

public int lastIndexOf(Object elem)

Возвращает индекс последнего вхождения elem.

Параметры:

elem - желаемый компонент

Возвращает:

индекс последнего вхождения elem в списке; возвращает -1, если объект не найден

См. также:

Vector.lastIndexOf(Object)

lastIndexOf

public int lastIndexOf(Object elem,
                       int index)

Выполняет обратный поиск elem, начиная с указанного индекса, и возвращает индекс к нему.

Параметры:

elem - желаемый компонент

index - индекс, с которого следует начать поиск

Возвращает:

индекс последнего вхождения elem в этом списке в позиции меньше index; возвращает -1, если объект не найден

См. также:

Vector.lastIndexOf(Object,int)

elementAt

public E elementAt(int index)

Возвращает компонент по указанному индексу. Выбрасывает исключение ArrayIndexOutOfBoundsException, если индекс отрицательный или не меньше размера списка.

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.

Параметры:

index - индекс в этом списке

Возвращает:

компонент по указанному индексу

См. также:

get(int), Vector.elementAt(int)

firstElement

public E firstElement()

Возвращает первый компонент этого списка. Выбрасывает исключение NoSuchElementException, если этот вектор не содержит компонентов.

Возвращает:

первый компонент этого списка

См. также:

Vector.firstElement()

lastElement

public E lastElement()

Возвращает последний компонент списка. Выбрасывает исключение NoSuchElementException, если этот вектор не содержит компонентов.

Возвращает:

последний компонент списка

См. также:

Vector.lastElement()

setElementAt

public void setElementAt(E element,
                         int index)

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.

Параметры:

element - на что должен быть установлен компонент

index - указанный индекс

См. также:

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

removeElementAt

public void removeElementAt(int index)

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.

Параметры:

index - индекс объекта для удаления

См. также:

remove(int), Vector.removeElementAt(int)

insertElementAt

public void insertElementAt(E element,
                            int index)

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.

Параметры:

element - компонент для вставки

index - место для вставки нового компонента

Исключения:

ArrayIndexOutOfBoundsException - если индекс был неверен

См. также:

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

addElement

public void addElement(E element)

Добавляет указанный компонент в конец этого списка.

Параметры:

element - компонент, который нужно добавить

См. также:

Vector.addElement(Object)

removeElement

public boolean removeElement(Object obj)

Удаляет первое (с наименьшим индексом) вхождение аргумента из этого списка.

Параметры:

obj — компонент, который нужно удалить

Возвращает:

true , если аргумент был компонентом этого списка; false в противном случае

См. также:

Vector.removeElement(Object)

removeAllElements

public void removeAllElements()

Удаляет все компоненты из этого списка и устанавливает его размер в ноль.

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.

См. также:

clear(), Vector.removeAllElements()

toString

public String toString()

Возвращает строку, отображающую и идентифицирующую свойства этого объекта.

Переопределяет:

toString в классе Object

Возвращает:

строковое представление этого объекта

toArray

public Object[] toArray()

Возвращает массив, содержащий все элементы этого списка в правильном порядке.

Возвращает:

массив, содержащий элементы списка

См. также:

Vector.toArray()

get

public E get(int index)

Параметры:

index — индекс возвращаемого элемента

set

public E set(int index,
             E element)

Параметры:

index — индекс заменяемого элемента

element — элемент, который будет сохранен по указанному индексу

Возвращает:

элемент, который ранее находился по указанному индексу

add

public void add(int index,
                E element)

Параметры:

index — индекс, в который необходимо вставить указанный элемент

element — вставляемый элемент

remove

public E remove(int index)

Параметры:

index — индекс удаляемого элемента

Возвращает:

элемент, который ранее находился по указанному индексу

clear

public void clear()

Удаляет все элементы из этого списка. Список будет пустым после возврата этого вызова (если не будет исключения).

removeRange

public void removeRange(int fromIndex,
                        int toIndex)

Параметры:

fromIndex — индекс нижней границы диапазона

toIndex — индекс верхней границы диапазона

См. также:

remove(int)