Класс SpinnerListModel

java.lang.Object

javax.swing.AbstractSpinnerModel

javax.swing.SpinnerListModel

Все реализуемые интерфейсы:: Serializable, SpinnerModel

public class SpinnerListModel extends AbstractSpinnerModel implements Serializable

Простая реализация SpinnerModel, значения которой задаются массивом или List. Например, чтобы создать модель, заданную массивом названий дней недели:

String[] days = new DateFormatSymbols().getWeekdays();
SpinnerModel model = new SpinnerListModel(Arrays.asList(days).subList(1, 8));

Этот класс хранит только ссылку на массив или List, поэтому, если элемент базовой последовательности изменится, приложение должно уведомить ChangeListeners, вызвав fireStateChanged.

Эта модель наследует ChangeListener. Объекты ChangeListener уведомляются при изменении свойств модели value или list.

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

1.4

См. также:

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

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

listenerList

Модификатор и тип	Поле	Описание
`protected EventListenerList`	`listenerList`	Список ChangeListener для этой модели.

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

Конструктор	Описание
`SpinnerListModel()`	Создает практически пустую `SpinnerListModel`.
`SpinnerListModel(Object[] values)`	Создает `SpinnerModel`, последовательность значений которой задается указанным массивом.
`SpinnerListModel(List<?> values)`	Создает `SpinnerModel`, последовательность значений которой задается указанным `List`.

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

Модификатор и тип	Метод	Описание
`List<?>`	`getList()`	Возвращает `List`, задающий последовательность для этой модели.
`Object`	`getNextValue()`	Возвращает следующее допустимое значение базовой последовательности или `null`, если значение уже является последним элементом.
`Object`	`getPreviousValue()`	Возвращает предыдущий элемент базовой последовательности или `null`, если значение уже является первым элементом.
`Object`	`getValue()`	Возвращает текущий элемент последовательности.
`void`	`setList(List<?> list)`	Изменяет список, задающий эту последовательность, и устанавливает индекс `value` модели в ноль.
`void`	`setValue(Object elt)`	Изменяет текущий элемент последовательности и уведомляет `ChangeListeners`.

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

addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener

Модификатор и тип	Метод	Описание
`void`	`addChangeListener(ChangeListener l)`	Добавляет ChangeListener в список слушателей модели.
`protected void`	`fireStateChanged()`	Вызывает метод stateChanged() каждого ChangeListener.
`ChangeListener[]`	`getChangeListeners()`	Возвращает массив всех `ChangeListener`, добавленных в эту модель AbstractSpinnerModel с помощью addChangeListener().
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех слушателей указанного типа, добавленных в эту модель.
`void`	`removeChangeListener(ChangeListener l)`	Удаляет ChangeListener из списка слушателей модели.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 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()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо истечения заданного промежутка реального времени.

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

SpinnerListModel

public SpinnerListModel(List<?> values)

Создает SpinnerModel, последовательность значений которой задается указанным List. Начальным значением (текущим элементом) модели будет values.get(0). Если values равно null или имеет нулевой размер, выбрасывается IllegalArgumentException.

Параметры:: values — последовательность, представляемая этой моделью
Исключения:: IllegalArgumentException — если values равно null или имеет нулевой размер

SpinnerListModel

public SpinnerListModel(Object[] values)

Создает SpinnerModel, последовательность значений которой задается указанным массивом. Начальным значением модели будет values[0]. Если values равно null или имеет нулевую длину, выбрасывается IllegalArgumentException.

Параметры:: values — последовательность, представляемая этой моделью
Исключения:: IllegalArgumentException — если values равно null или имеет нулевую длину

SpinnerListModel

public SpinnerListModel()

Создает практически пустую SpinnerListModel. Список модели будет содержать один строковый элемент "empty".

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

getList

public List<?> getList()

Возвращает List, задающий последовательность для этой модели.

Возвращает:

значение свойства list

См. также:

setList

public void setList(List<?> list)

Изменяет список, задающий эту последовательность, и устанавливает индекс value модели в ноль. Обратите внимание, что list не копируется: модель лишь хранит ссылку на него.

Этот метод генерирует ChangeEvent, если list не совпадает с текущим списком.

Параметры:

list — последовательность, представляемая этой моделью

Исключения:

IllegalArgumentException — если list равно null или имеет нулевую длину

См. также:

getValue

public Object getValue()

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

Указан в:

getValue в интерфейсе SpinnerModel

Возвращает:

свойство value

См. также:

setValue

public void setValue(Object elt)

Изменяет текущий элемент последовательности и уведомляет ChangeListeners. Если указанное значение не совпадает ни с одним элементом базовой последовательности, выбрасывается IllegalArgumentException. В следующем примере вызов setValue приведет к выбрасыванию исключения:

String[] values = {"one", "two", "free", "four"};
SpinnerModel model = new SpinnerListModel(values);
model.setValue("TWO");

Указан в:

setValue в интерфейсе SpinnerModel

Параметры:

elt — элемент последовательности, который станет текущим значением модели

Исключения:

IllegalArgumentException — если указанное значение недопустимо

См. также:

getNextValue

public Object getNextValue()

Возвращает следующее допустимое значение базовой последовательности или null, если значение уже является последним элементом.

Указан в:

getNextValue в интерфейсе SpinnerModel

Возвращает:

следующее допустимое значение базовой последовательности или null, если значение уже является последним элементом

См. также:

getPreviousValue

public Object getPreviousValue()

Возвращает предыдущий элемент базовой последовательности или null, если значение уже является первым элементом.

Указан в:

getPreviousValue в интерфейсе SpinnerModel

Возвращает:

предыдущий элемент базовой последовательности или null, если значение уже является первым элементом

См. также:

© 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.