Интерфейс SpinnerModel

Все известные реализующие классы:: AbstractSpinnerModel, SpinnerDateModel, SpinnerListModel, SpinnerNumberModel

public interface SpinnerModel

Модель потенциально неограниченной последовательности значений объектов. Эта модель похожа на ListModel, однако имеет несколько важных отличий:

Число элементов последовательности не обязательно ограничено.
Модель не поддерживает индексированный произвольный доступ к элементам последовательности. Одновременно доступны только три значения последовательности: текущее, следующее и предыдущее.
Текущий элемент последовательности можно задать.

У SpinnerModel есть три свойства, и только первое доступно для чтения и записи.

value: Текущий элемент последовательности.
nextValue: Следующий элемент или null, если value является последним элементом последовательности.
previousValue: Предыдущий элемент или null, если value является первым элементом последовательности.

При изменении свойства value вызывается уведомление для ChangeListeners. SpinnerModel может уведомлять ChangeListeners и при других обстоятельствах.

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

1.4

См. также:

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

Модификатор и тип	Метод	Описание
`void`	`addChangeListener(ChangeListener l)`	Добавляет `ChangeListener` в список слушателей модели.
`Object`	`getNextValue()`	Возвращает объект последовательности, следующий за объектом, возвращённым `getValue()`.
`Object`	`getPreviousValue()`	Возвращает объект последовательности, предшествующий объекту, возвращённому `getValue()`.
`Object`	`getValue()`	Текущий элемент последовательности.
`void`	`removeChangeListener(ChangeListener l)`	Удаляет `ChangeListener` из списка слушателей модели.
`void`	`setValue(Object value)`	Изменяет текущее значение модели; обычно это значение отображается в `editor` компоненте `JSpinner`.

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

getValue

Object getValue()

Текущий элемент последовательности. Обычно этот элемент отображается в editor компоненте JSpinner.

Возвращает:

текущее значение счётчика.

См. также:

setValue

void setValue(Object value)

Изменяет текущее значение модели; обычно это значение отображается в editor компоненте JSpinner. Если реализация SpinnerModel не поддерживает указанное значение, выбрасывается IllegalArgumentException. Например, SpinnerModel для чисел может поддерживать только значения, кратные десяти. В этом случае model.setValue(new Number(11)) выбросит исключение.

Параметры:

value — новое значение счётчика

Выбрасывает:

IllegalArgumentException — если value недопустимо

См. также:

getNextValue

Object getNextValue()

Возвращает объект последовательности, следующий за объектом, возвращённым getValue(). Если достигнут конец последовательности, возвращает null. Вызов этого метода не изменяет value.

Возвращает:

следующее допустимое значение или null, если такого значения нет

См. также:

getPreviousValue

Object getPreviousValue()

Возвращает объект последовательности, предшествующий объекту, возвращённому getValue(). Если достигнут конец последовательности, возвращает null. Вызов этого метода не изменяет value.

Возвращает:

предыдущее допустимое значение или null, если такого значения нет

См. также:

addChangeListener

void addChangeListener(ChangeListener l)

Добавляет ChangeListener в список слушателей модели. ChangeListeners необходимо уведомлять при изменении value модели.

Параметры:

l — ChangeListener для добавления

См. также:

removeChangeListener

void removeChangeListener(ChangeListener l)

Удаляет ChangeListener из списка слушателей модели.

Параметры:

l — ChangeListener для удаления

См. также:

© 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/SpinnerModel.html