Класс DefaultListModel<E>

java.lang.Object

javax.swing.AbstractListModel<E>

javax.swing.DefaultListModel<E>

Type Parameters:: E — тип элементов этого списка

Все реализованные интерфейсы:: Serializable, ListModel<E>

public class DefaultListModel<E> extends AbstractListModel<E>

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

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

С тех пор:: 1.2

Краткое описание полей

Поля, объявленные в классе javax.swing.AbstractListModel

listenerList

Краткое описание конструкторов

Конструктор	Описание
`DefaultListModel()`	Создаёт `DefaultListModel`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`add(int index, E element)`	Вставляет указанный элемент в указанную позицию в этом списке.
`void`	`addAll(int index, Collection<? extends E> c)`	Добавляет все элементы из коллекции, начиная с указанного индекса.
`void`	`addAll(Collection<? extends E> c)`	Добавляет все элементы из коллекции в список.
`void`	`addElement(E element)`	Добавляет указанный компонент в конец этого списка.
`int`	`capacity()`	Возвращает текущую ёмкость этого списка.
`void`	`clear()`	Удаляет все элементы из этого списка.
`boolean`	`contains(Object elem)`	Проверяет, является ли указанный объект компонентом в этом списке.
`void`	`copyInto(Object[] anArray)`	Копирует компоненты этого списка в указанный массив.
`E`	`elementAt(int index)`	Возвращает компонент в указанном индексе.
`Enumeration<E>`	`elements()`	Возвращает перечисление компонентов этого списка.
`void`	`ensureCapacity(int minCapacity)`	Увеличивает ёмкость этого списка, если необходимо, чтобы он мог содержать по меньшей мере количество компонентов, заданное аргументом минимальной ёмкости.
`E`	`firstElement()`	Возвращает первый компонент этого списка.
`E`	`get(int index)`	Возвращает элемент в указанной позиции в этом списке.
`E`	`getElementAt(int index)`	Возвращает компонент по указанному индексу.
`int`	`getSize()`	Возвращает количество компонентов в этом списке.
`int`	`indexOf(Object elem)`	Ищет первое вхождение `elem`.
`int`	`indexOf(Object elem, int index)`	Ищет первое вхождение `elem`, начиная поиск с `index`.
`void`	`insertElementAt(E element, int index)`	Вставляет указанный элемент как компонент в этот список в указанном `index`.
`boolean`	`isEmpty()`	Проверяет, содержит ли этот список компоненты.
`E`	`lastElement()`	Возвращает последний компонент списка.
`int`	`lastIndexOf(Object elem)`	Возвращает индекс последнего вхождения `elem`.
`int`	`lastIndexOf(Object elem, int index)`	Ищет `elem` в обратном порядке, начиная с указанного индекса, и возвращает индекс найденного элемента.
`E`	`remove(int index)`	Удаляет элемент в указанной позиции в этом списке.
`void`	`removeAllElements()`	Удаляет все компоненты из этого списка и устанавливает его размер в ноль.
`boolean`	`removeElement(Object obj)`	Удаляет первое (с наименьшим индексом) вхождение аргумента из этого списка.
`void`	`removeElementAt(int index)`	Удаляет компонент в указанном индексе.
`void`	`removeRange(int fromIndex, int toIndex)`	Удаляет компоненты в указанном диапазоне индексов.
`E`	`set(int index, E element)`	Заменяет элемент в указанной позиции в этом списке указанным элементом.
`void`	`setElementAt(E element, int index)`	Устанавливает компонент в указанном `index` этого списка в указанный элемент.
`void`	`setSize(int newSize)`	Устанавливает размер этого списка.
`int`	`size()`	Возвращает количество компонентов в этом списке.
`Object[]`	`toArray()`	Возвращает массив, содержащий все элементы в этом списке в правильном порядке.
`String`	`toString()`	Возвращает строку, отображающую и идентифицирующую свойства этого объекта.
`void`	`trimToSize()`	Уменьшает ёмкость этого списка до текущего размера списка.

Методы, объявленные в классе javax.swing.AbstractListModel

addListDataListener, fireContentsChanged, fireIntervalAdded, fireIntervalRemoved, getListDataListeners, getListeners, removeListDataListener

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

DefaultListModel

public DefaultListModel()

Создаёт DefaultListModel.

Подробное описание методов

getSize

public int getSize()

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

Этот метод идентичен методу size, который реализует интерфейс List, определённый в рамках фреймворка 1.2 Collections. Этот метод существует вместе с setSize, чтобы size был идентифицируем как свойство JavaBean.

Возвращает:

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

См. также:

getElementAt

public E getElementAt(int index)

Возвращает компонент по указанному индексу.

Примечание: Хотя этот метод не устарел, предпочтительным является использование метода get(int), который реализует интерфейс List, определённый в рамках фреймворка 1.2 Collections.

Параметры:

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

Возвращает:

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

Исключение:

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

См. также:

copyInto

public void copyInto(Object[] anArray)

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

Параметры:

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

См. также:

trimToSize

public void trimToSize()

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

См. также:

ensureCapacity

public void ensureCapacity(int minCapacity)

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

Параметры:

minCapacity - желаемый минимальный размер буфера

См. также:

setSize

public void setSize(int newSize)

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

Параметры:

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

См. также:

capacity

public int capacity()

Возвращает текущий размер буфера этого списка.

Возвращает:

текущий размер буфера

См. также:

size

public int size()

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

Возвращает:

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

См. также:

isEmpty

public boolean isEmpty()

Проверяет, пуст ли этот список.

Возвращает:

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

См. также:

elements

public Enumeration<E> elements()

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

Возвращает:

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

См. также:

contains

public boolean contains(Object elem)

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

Параметры:

elem - объект

Возвращает:

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

См. также:

indexOf

public int indexOf(Object elem)

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

Параметры:

elem - объект

Возвращает:

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

См. также:

indexOf

public int indexOf(Object elem, int index)

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

Параметры:

elem - искомый компонент

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

Возвращает:

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

См. также:

lastIndexOf

public int lastIndexOf(Object elem)

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

Параметры:

elem - искомый компонент

Возвращает:

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

См. также:

lastIndexOf

public int lastIndexOf(Object elem, int index)

Ищет обратное вхождение elem, начиная с указанного индекса, и возвращает его индекс.

Параметры:

elem - искомый компонент

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

Возвращает:

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

См. также:

elementAt

public E elementAt(int index)

Возвращает компонент по указанному индексу.

Примечание: Хотя этот метод не устарел, предпочтительным является использование метода get(int), который реализует интерфейс List, определённый в рамках фреймворка 1.2 Collections.

Параметры:

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

Возвращает:

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

Исключение:

ArrayIndexOutOfBoundsException - если индекс отрицательный или не меньше размера списка

См. также:

firstElement

public E firstElement()

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

Возвращает:

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

Исключение:

NoSuchElementException - если в этом векторе нет компонентов

См. также:

lastElement

public E lastElement()

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

Возвращает:

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

Исключение:

NoSuchElementException - если в этом векторе нет компонентов

См. также:

setElementAt

public void setElementAt(E element, int index)

Устанавливает компонент в указанном index этого списка в качестве указанного элемента. Предыдущий компонент в этом положении отбрасывается.

Примечание: Хотя этот метод не устарел, предпочтительным методом является set(int,Object), который реализует интерфейс List, определённый в рамках фреймворка Collections 1.2.

Parameters:

element - значение, на которое необходимо установить компонент

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

Throws:

ArrayIndexOutOfBoundsException - если индекс некорректен

See Also:

removeElementAt

public void removeElementAt(int index)

Удаляет компонент по указанному индексу.

Примечание: Хотя этот метод не устарел, предпочтительным методом является remove(int), который реализует интерфейс List, определённый в рамках фреймворка Collections 1.2.

Parameters:

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

Throws:

ArrayIndexOutOfBoundsException - если индекс некорректен

See Also:

insertElementAt

public void insertElementAt(E element, int index)

Вставляет указанный элемент в качестве компонента в этот список по указанному index.

Примечание: Хотя этот метод не устарел, предпочтительным методом является add(int,Object), который реализует интерфейс List, определённый в рамках фреймворка Collections 1.2.

Parameters:

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

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

Throws:

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

See Also:

addElement

public void addElement(E element)

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

Parameters:

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

See Also:

removeElement

public boolean removeElement(Object obj)

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

Parameters:

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

Returns:

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

See Also:

removeAllElements

public void removeAllElements()

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

Примечание: Хотя этот метод не устарел, предпочтительным методом является clear, который реализует интерфейс List, определённый в рамках фреймворка Collections 1.2.

See Also:

toString

public String toString()

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

Overrides:: toString в классе Object
Returns:: представление этого объекта в виде строки

toArray

public Object[] toArray()

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

Returns:

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

See Also:

get

public E get(int index)

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

Parameters:: index - индекс возвращаемого элемента
Returns:: элемент по указанной позиции в этом списке
Throws:: ArrayIndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index >= size())

set

public E set(int index, E element)

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

Parameters:: index - индекс заменяемого элемента; element - элемент, который будет сохранён по указанной позиции
Returns:: элемент, который ранее находился по указанной позиции
Throws:: ArrayIndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index >= size())

add

public void add(int index, E element)

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

Parameters:: index - индекс, по которому необходимо вставить указанный элемент; element - вставляемый элемент
Throws:: ArrayIndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index > size())

remove

public E remove(int index)

Удаляет элемент по указанной позиции в этом списке. Возвращает удалённый из списка элемент.

Parameters:: index - индекс удаляемого элемента
Returns:: элемент, который ранее находился по указанной позиции
Throws:: ArrayIndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index >= size())

clear

public void clear()

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

removeRange

public void removeRange(int fromIndex, int toIndex)

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

Parameters:

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

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

Throws:

ArrayIndexOutOfBoundsException - если индекс некорректен

IllegalArgumentException - если fromIndex > toIndex

See Also:

addAll

public void addAll(Collection<? extends E> c)

Добавляет все элементы, присутствующие в коллекции, в список.

Parameters:: c - коллекция, содержащая добавляемые элементы
Throws:: NullPointerException - если c равно null
Since:: 11

addAll

public void addAll(int index, Collection<? extends E> c)

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

Parameters:: index - индекс, с которого необходимо вставить первые элементы из указанной коллекции; c - коллекция, содержащая добавляемые элементы
Throws:: ArrayIndexOutOfBoundsException - если index не попадает в диапазон текущего количества элементов; NullPointerException - если c равно null
Since:: 11

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/DefaultListModel.html