Класс 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
См. также:: JSpinner, SpinnerModel, AbstractSpinnerModel, SpinnerNumberModel, SpinnerDateModel, Сериализованная форма

Поля

Поля, объявленные в классе javax.swing.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`.

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

addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener

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

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

Конструкторы

SpinnerListModel

public SpinnerListModel(List<?> values)

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

Параметры:: 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(java.util.List<?>)

setList

public void setList(List<?> list)

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

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

Параметры:: list - последовательность, которую представляет эта модель
Исключения:: IllegalArgumentException - если list null или имеет нулевую длину
См. также:: getList()

getValue

public Object getValue()

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

Определено в:: getValue в интерфейсе SpinnerModel
Возвращает:: свойство value
См. также:: SpinnerModel.getValue(), setValue(java.lang.Object)

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 - если указанное значение недопустимо
См. также:: SpinnerModel.setValue(java.lang.Object), getValue()

getNextValue

public Object getNextValue()

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

Определено в:: getNextValue в интерфейсе SpinnerModel
Возвращает:: следующее допустимое значение базовой последовательности или null если значение уже является последним элементом
См. также:: SpinnerModel.getNextValue(), getPreviousValue()

getPreviousValue

public Object getPreviousValue()

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

Определено в:: getPreviousValue в интерфейсе SpinnerModel
Возвращает:: предыдущий элемент базовой последовательности или null если значение уже является первым элементом
См. также:: SpinnerModel.getPreviousValue(), getNextValue()