Класс 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. Уведомления ChangeListeners отправляются всякий раз, когда изменяются свойства модели value или list.

С версии:

1.4

См. также:

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

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

listenerList

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

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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

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