Класс SpinnerListModel

java.lang.Object

javax.swing.AbstractSpinnerModel

javax.swing.SpinnerListModel

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

public class SpinnerListModel extends AbstractSpinnerModel implements Serializable

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

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

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

Эта модель наследует ChangeListener. ChangeListener уведомляются всякий раз, когда изменяются свойства value или list модели.

С:

1.4

См. также:

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

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

listenerList

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

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

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

Модификатор и тип	Метод	Описание
`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, последовательность значений которого определяется указанным списком. Начальное значение (текущий элемент) модели будет values.get(0). Если values пустой или имеет нулевую длину, выбрасывается IllegalArgumentException.

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

SpinnerListModel

public SpinnerListModel(Object[] values)

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

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

SpinnerListModel

public SpinnerListModel()

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

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

getList

public List<?> getList()

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

Возвращает:

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

См. также:

setList

public void setList(List<?> list)

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

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

Параметры:

list - последовательность, которую представляет эта модель

Исключения:

IllegalArgumentException - если list пустой или имеет нулевую длину

См. также:

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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/SpinnerListModel.html