Класс DefaultListModel<E>

java.lang.Object

javax.swing.AbstractListModel<E>

javax.swing.DefaultListModel<E>

Параметры типа:: E - тип элементов этого списка

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

public class DefaultListModel<E> extends AbstractListModel<E>

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

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями 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 в рамках фреймворка Collections версии 1.2. Этот метод существует совместно с setSize, чтобы size можно было идентифицировать как свойство JavaBean.

Возвращает:

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

См. также:

getElementAt

public E getElementAt(int index)

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

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

Параметры:

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 в рамках фреймворка Collections версии 1.2.

Параметры:

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

addAll

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

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

Parameters:: index - индекс, с которого следует вставить первый элемент из указанной коллекции; c - коллекция, содержащая элементы для добавления
Throws:: ArrayIndexOutOfBoundsException - если index не попадает в диапазон текущего количества элементов; NullPointerException - если c равно 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