Spec-Zone.ru › OpenJDK 27

Класс 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, в пакет java.beans добавлена поддержка долгосрочного хранения всех JavaBeans. См. XMLEncoder.

Начиная с версии:
1.2

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

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

listenerList
Модификатор и тип Поле Описание
protected EventListenerList 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
Модификатор и тип Метод Описание
void addListDataListener(ListDataListener l)
Добавляет слушателя в список; он получает уведомление при каждом изменении модели данных.
protected void fireContentsChanged(Object source, int index0, int index1)
Подклассы AbstractListModel должны вызывать этот метод после изменения одного или нескольких элементов списка.
protected void fireIntervalAdded(Object source, int index0, int index1)
Подклассы AbstractListModel должны вызывать этот метод после добавления в модель одного или нескольких элементов.
protected void fireIntervalRemoved(Object source, int index0, int index1)
Подклассы AbstractListModel должны вызывать этот метод после удаления из модели одного или нескольких элементов.
ListDataListener[] getListDataListeners()
Возвращает массив всех слушателей данных списка, зарегистрированных в этом AbstractListModel.
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, зарегистрированных в данный момент в качестве FooListener в этой модели.
void removeListDataListener(ListDataListener l)
Удаляет слушателя из списка; он получает уведомление при каждом изменении модели данных.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создаёт и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли другой объект этому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Финализация устарела и подлежит удалению в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо истечения заданного промежутка реального времени.

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

DefaultListModel

public DefaultListModel()
Создаёт DefaultListModel.

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

getSize

public int getSize()
Возвращает количество элементов в этом списке.

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

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

getElementAt

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

removeElementAt

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

insertElementAt

public void insertElementAt(E element, int index)
Вставляет указанный элемент в этот список как элемент с указанным index.
Примечание: Хотя этот метод не объявлен устаревшим, рекомендуется использовать add(int,Object), реализующий интерфейс List, определённый в Collections Framework версии 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 Framework версии 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, 2026, 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.

Spec-Zone.ru

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