Spec-Zone.ru › OpenJDK 17

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

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

Возвращает:
количество компонентов в этом списке
См. также:
  • 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 , определённый в рамках фреймворка 1.2 Collections.
Parameters:
index - индекс объекта для удаления
Throws:
ArrayIndexOutOfBoundsException - если индекс недопустим
See Also:
  • remove(int)
  • Vector.removeElementAt(int)

insertElementAt

public void insertElementAt(E element, int index)
Вставляет указанный элемент в качестве компонента в этот список по указанному index.
Примечание: Хотя этот метод не устарел, предпочтительнее использовать метод add(int,Object), который реализует интерфейс List , определённый в рамках фреймворка 1.2 Collections.
Parameters:
element - компонент для вставки
index - позиция для вставки нового компонента
Throws:
ArrayIndexOutOfBoundsException - если индекс был недопустимым
See Also:
  • add(int,Object)
  • Vector.insertElementAt(Object,int)

addElement

public void addElement(E element)
Добавляет указанный компонент в конец этого списка.
Parameters:
element - компонент для добавления
See Also:
  • Vector.addElement(Object)

removeElement

public boolean removeElement(Object obj)
Удаляет первое (с наименьшим индексом) вхождение аргумента из этого списка.
Parameters:
obj - компонент для удаления
Returns:
true если аргумент был компонентом этого списка; false в противном случае
See Also:
  • Vector.removeElement(Object)

removeAllElements

public void removeAllElements()
Удаляет все компоненты из этого списка и устанавливает его размер в ноль.
Примечание: Хотя этот метод не устарел, предпочтительнее использовать метод clear, который реализует интерфейс List , определённый в рамках фреймворка 1.2 Collections.
See Also:
  • clear()
  • Vector.removeAllElements()

toString

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

toArray

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

get

public E get(int index)
Возвращает элемент по указанному индексу в этом списке.
Parameters:
index - индекс возвращаемого элемента
Returns:
элемент по указанному индексу в этом списке
Throws:
ArrayIndexOutOfBoundsException - если индекс вне диапазона (index &lt; 0 || index &gt;= size())

set

public E set(int index, E element)
Заменяет элемент по указанному индексу в этом списке указанным элементом.
Parameters:
index - индекс заменяемого элемента
element - элемент, который будет сохранён по указанному индексу
Returns:
предыдущий элемент по указанному индексу
Throws:
ArrayIndexOutOfBoundsException - если индекс вне диапазона (index &lt; 0 || index &gt;= size())

add

public void add(int index, E element)
Вставляет указанный элемент по указанному индексу в этот список.
Parameters:
index - индекс, по которому необходимо вставить указанный элемент
element - вставляемый элемент
Throws:
ArrayIndexOutOfBoundsException - если индекс вне диапазона (index &lt; 0 || index &gt; size())

remove

public E remove(int index)
Удаляет элемент по указанному индексу в этом списке. Возвращает удалённый элемент.
Parameters:
index - индекс удаляемого элемента
Returns:
предыдущий элемент по указанному индексу
Throws:
ArrayIndexOutOfBoundsException - если индекс вне диапазона (index &lt; 0 || index &gt;= size())

clear

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

removeRange

public void removeRange(int fromIndex, int toIndex)
Удаляет компоненты в указанном диапазоне индексов. Удаление является включительным, поэтому указание диапазона (1,5) удаляет компонент с индексом 1 и компонент с индексом 5, а также все компоненты между ними.
Parameters:
fromIndex - индекс нижней границы диапазона
toIndex - индекс верхней границы диапазона
Throws:
ArrayIndexOutOfBoundsException - если индекс недопустим
IllegalArgumentException - если fromIndex &gt; toIndex
See Also:
  • remove(int)

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, 2021, 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/17/docs/api/java.desktop/javax/swing/DefaultListModel.html

Spec-Zone.ru

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