Spec-Zone.ru › OpenJDK 25

Класс 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

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

Поля, объявленные в классе 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()
Уменьшает ёмкость этого списка до его текущего размера.

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

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

Методы, объявленные в классе 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.

Возвращает:
количество компонентов в этом списке
См. также:
  • size()

getElementAt

public E getElementAt(int index)
Возвращает компонент с указанным индексом.
Примечание: Хотя этот метод не является устаревшим, рекомендуется использовать get(int), который реализует интерфейс List, определенный в платформе Collections версии 1.2.
Параметры:
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 в списке; возвращает elem, если объект не найден
См. также:
  • 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)
Возвращает компонент с указанным индексом.
Примечание: Хотя этот метод не является устаревшим, рекомендуется использовать get(int), который реализует интерфейс List, определенный в платформе Collections версии 1.2.
Параметры:
index — индекс элемента в этом списке
Возвращает:
компонент с указанным индексом
Вызывает исключение:
ArrayIndexOutOfBoundsException — если индекс отрицателен или не меньше размера списка
См. также:
  • 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)
Задает для компонента с указанным index этого списка значение указанного элемента. Предыдущий компонент на этой позиции удаляется.
Примечание: Хотя этот метод не является устаревшим, рекомендуется использовать set(int,Object), который реализует интерфейс List, определенный в платформе Collections версии 1.2.
Параметры:
element — значение, которое будет присвоено компоненту
index — указанный индекс
Вызывает исключение:
ArrayIndexOutOfBoundsException — если индекс недопустим
См. также:
  • set(int,Object)
  • Vector.setElementAt(Object,int)

removeElementAt

public void removeElementAt(int index)
Удаляет компонент с указанным индексом.
Примечание: Хотя этот метод не является устаревшим, рекомендуется использовать remove(int), который реализует интерфейс List, определенный в платформе Collections версии 1.2.
Параметры:
index — индекс удаляемого объекта
Вызывает исключение:
ArrayIndexOutOfBoundsException — если индекс недопустим
См. также:
  • remove(int)
  • Vector.removeElementAt(int)

insertElementAt

public void insertElementAt(E element, int index)
Вставляет указанный элемент как компонент этого списка в указанную index.
Примечание: Хотя этот метод не является устаревшим, рекомендуется использовать add(int,Object), который реализует интерфейс List, определенный в платформе Collections версии 1.2.
Параметры:
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()
Удаляет все компоненты из этого списка и устанавливает его размер равным нулю.
Примечание: Хотя этот метод не является устаревшим, рекомендуется использовать clear, который реализует интерфейс List, определенный в платформе Collections версии 1.2.
См. также:
  • clear()
  • Vector.removeAllElements()

toString

public String toString()
Возвращает строку, отображающую свойства этого объекта и идентифицирующую его.
Переопределяет:
toString в классе Object
Возвращает:
строковое представление этого объекта

toArray

public Object[] toArray()
Возвращает массив, содержащий все элементы этого списка в правильном порядке.
Возвращает:
массив, содержащий элементы списка
См. также:
  • Vector.toArray()

get

public E get(int index)
Возвращает элемент, находящийся в указанной позиции этого списка.
Параметры:
index — индекс возвращаемого элемента
Возвращает:
элемент, находящийся в указанной позиции этого списка
Вызывает исключение:
ArrayIndexOutOfBoundsException — если индекс выходит за допустимые границы (index &lt; 0 || index &gt;= size())

set

public E set(int index, E element)
Заменяет элемент в указанной позиции этого списка указанным элементом.
Параметры:
index — индекс заменяемого элемента
element — элемент, который будет сохранен в указанной позиции
Возвращает:
элемент, ранее находившийся в указанной позиции
Вызывает исключение:
ArrayIndexOutOfBoundsException — если индекс выходит за допустимые границы (index &lt; 0 || index &gt;= size())

add

public void add(int index, E element)
Вставляет указанный элемент в указанную позицию этого списка.
Параметры:
index — индекс, по которому вставляется указанный элемент
element — вставляемый элемент
Вызывает исключение:
ArrayIndexOutOfBoundsException — если индекс выходит за допустимые границы (index &lt; 0 || index &gt; size())

remove

public E remove(int index)
Удаляет элемент из указанной позиции этого списка. Возвращает элемент, удаленный из списка
Параметры:
index — индекс удаляемого элемента
Возвращает:
элемент, ранее находившийся в указанной позиции
Вызывает исключение:
ArrayIndexOutOfBoundsException — если индекс выходит за допустимые границы (index &lt; 0 || index &gt;= size())

clear

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

removeRange

public void removeRange(int fromIndex, int toIndex)
Удаляет компоненты в указанном диапазоне индексов. Диапазон включает обе границы: указание диапазона (1,5) удаляет компоненты с индексами 1 и 5, а также все компоненты между ними.
Параметры:
fromIndex — индекс нижней границы диапазона
toIndex — индекс верхней границы диапазона
Вызывает исключение:
ArrayIndexOutOfBoundsException — если индекс недопустим
IllegalArgumentException — если fromIndex &gt; toIndex
См. также:
  • remove(int)

addAll

public void addAll(Collection<? extends E> c)
Добавляет в список все элементы коллекции.
Параметры:
c — коллекция, содержащая добавляемые элементы
Вызывает исключение:
NullPointerException — если c имеет значение null
С версии:
11

addAll

public void addAll(int index, Collection<? extends E> c)
Добавляет все элементы коллекции, начиная с указанного индекса.
Параметры:
index — индекс, по которому вставляется первый элемент указанной коллекции
c — коллекция, содержащая добавляемые элементы
Вызывает исключение:
ArrayIndexOutOfBoundsException — если index не входит в диапазон количества элементов, имеющихся в данный момент
NullPointerException — если c имеет значение null
С версии:
11

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе документации Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/DefaultListModel.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API