Класс 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, в будущих версиях он будет полноценной реализацией интерфейса Collection.

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

С:
1.2
См. также:
Сериализованная форма

Поля

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

listenerList

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

Конструктор Описание
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()

Методы

getSize

public int getSize()

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

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

Возвращает:
количество компонентов в этом списке
См. также:
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 в списке; возвращает 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)

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

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 - если индекс отрицательный или не меньше размера списка
См. также:
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 этого списка в качестве указанного элемента. Предыдущий компонент в этой позиции отбрасывается. 

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 - указанный индекс
Исключения:
ArrayIndexOutOfBoundsException - если индекс недействителен
См. также:
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 - индекс объекта для удаления
Исключения:
ArrayIndexOutOfBoundsException - если индекс недействителен
См. также:
remove(int), Vector.removeElementAt(int)

insertElementAt

public void insertElementAt(E element,
                            int index)

Вставляет указанный элемент как компонент в этот список по указанному 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 - индекс возвращаемого элемента
Возвращает:
элемент в указанной позиции в этом списке
Исключение:
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

addAll

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

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

Параметры:
index - индекс, с которого следует вставить первый элемент из указанной коллекции
c - коллекция, содержащая элементы для добавления
Исключение:
ArrayIndexOutOfBoundsException - если index не попадает в диапазон текущего количества элементов
NullPointerException - если c равно null

© 1993, 2020, 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/11/docs/api/java.desktop/javax/swing/DefaultListModel.html

Spec-Zone .ru
спецификации, руководства, описания, API