Класс 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

См. также:

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

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

См. также:

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, 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/SpinnerListModel.html