Класс SpinnerNumberModel

java.lang.Object

javax.swing.AbstractSpinnerModel

javax.swing.SpinnerNumberModel

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

public class SpinnerNumberModel extends AbstractSpinnerModel implements Serializable

Модель для последовательностей чисел. Верхняя и нижняя границы последовательности определяются свойствами, называемыми minimum и maximum. Размер приращения или уменьшения, вычисляемый методами nextValue и previousValue, определяется свойством stepSize. Свойства minimum и maximum могут быть установлены в null для указания того, что у последовательности нет нижней или верхней границы. Все свойства в этом классе определяются с помощью двух общих типов: Number и Comparable, чтобы можно было использовать все числовые типы Java. Внутри поддерживаются только значения, тип которых является одним из примитивных типов Number: Double, Float, Long, Integer, Short, или Byte.

Чтобы создать модель для целочисленного диапазона от нуля до ста, с начальным значением пятьдесят, можно написать:

 Integer value = Integer.valueOf(50);
 Integer min = Integer.valueOf(0);
 Integer max = Integer.valueOf(100);
 Integer step = Integer.valueOf(1);
 SpinnerNumberModel model = new SpinnerNumberModel(value, min, max, step);
 int fifty = model.getNumber().intValue();

Спиннеры для целых чисел и чисел с плавающей точкой являются распространенными, поэтому предоставляются специальные конструкторы для этих случаев. Например, чтобы создать модель в предыдущем примере, можно также написать:

 SpinnerNumberModel model = new SpinnerNumberModel(50, 0, 100, 1);

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

С тех пор:

1.4

См. также:

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

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

listenerList

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

Конструктор	Описание
`SpinnerNumberModel()`	Создает модель `SpinnerNumberModel` без значения `minimum` или `maximum`, значение `stepSize` равно единице и начальное значение равно нулю.
`SpinnerNumberModel(double value, double minimum, double maximum, double stepSize)`	Создает модель `SpinnerNumberModel` со значениями `value`, `minimum`/`maximum` границ и `stepSize`.
`SpinnerNumberModel(int value, int minimum, int maximum, int stepSize)`	Создает модель `SpinnerNumberModel` со значениями `value`, `minimum`/`maximum` границ и `stepSize`.
`SpinnerNumberModel(Number value, Comparable<?> minimum, Comparable<?> maximum, Number stepSize)`	Создает модель `SpinnerModel`, представляющую замкнутую последовательность чисел от `minimum` до `maximum`.

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

Модификатор и тип	Метод	Описание
`Comparable<?>`	`getMaximum()`	Возвращает последнее число в последовательности.
`Comparable<?>`	`getMinimum()`	Возвращает первое число в этой последовательности.
`Object`	`getNextValue()`	Возвращает следующее число в последовательности.
`Number`	`getNumber()`	Возвращает значение текущего элемента последовательности.
`Object`	`getPreviousValue()`	Возвращает предыдущее число в последовательности.
`Number`	`getStepSize()`	Возвращает размер изменения значения, вычисляемого методами `getNextValue` и `getPreviousValue`.
`Object`	`getValue()`	Возвращает значение текущего элемента последовательности.
`void`	`setMaximum(Comparable<?> maximum)`	Изменяет верхнюю границу чисел в этой последовательности.
`void`	`setMinimum(Comparable<?> minimum)`	Изменяет нижнюю границу чисел в этой последовательности.
`void`	`setStepSize(Number stepSize)`	Изменяет размер изменения значения, вычисляемого методами `getNextValue` и `getPreviousValue`.
`void`	`setValue(Object value)`	Устанавливает текущее значение для этой последовательности.

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

addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener

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

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

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

SpinnerNumberModel

public SpinnerNumberModel(Number value, Comparable<?> minimum, Comparable<?> maximum, Number stepSize)

Создаёт SpinnerModel, представляющий замкнутую последовательность чисел от minimum до maximum. Методы nextValue и previousValue вычисляют элементы последовательности, соответственно, добавляя или вычитая stepSize. Все параметры должны быть взаимосвязаны Comparable, value и stepSize должны быть экземплярами Integer Long, Float, или Double.

Параметры minimum и maximum могут быть null для указания того, что диапазон не имеет верхней или нижней границы. Если value или stepSize равны null, или если оба minimum и maximum указаны и minimum > maximum, то генерируется IllegalArgumentException. Аналогично, если (minimum <= value <= maximum) ложно, генерируется IllegalArgumentException.

Параметры:: value - текущее (не null) значение модели; minimum - первое число в последовательности или null; maximum - последнее число в последовательности или null; stepSize - разность между элементами последовательности
Исключения:: IllegalArgumentException - если stepSize или value равно null или если следующее выражение ложно: minimum <= value <= maximum

SpinnerNumberModel

public SpinnerNumberModel(int value, int minimum, int maximum, int stepSize)

Создаёт SpinnerNumberModel со значениями value, minimum/maximum границами и stepSize.

Параметры:: value - текущее значение модели; minimum - первое число в последовательности; maximum - последнее число в последовательности; stepSize - разность между элементами последовательности
Исключения:: IllegalArgumentException - если следующее выражение ложно: minimum <= value <= maximum

SpinnerNumberModel

public SpinnerNumberModel(double value, double minimum, double maximum, double stepSize)

Создаёт SpinnerNumberModel со значениями value, minimum/maximum границами и stepSize.

Параметры:: value - текущее значение модели; minimum - первое число в последовательности; maximum - последнее число в последовательности; stepSize - разность между элементами последовательности
Исключения:: IllegalArgumentException - если следующее выражение ложно: minimum <= value <= maximum

SpinnerNumberModel

public SpinnerNumberModel()

Создаёт SpinnerNumberModel без minimum или maximum значения, stepSize равное единице, и начальным значением ноль.

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

setMinimum

public void setMinimum(Comparable<?> minimum)

Изменяет нижнюю границу для чисел в этой последовательности. Если minimum равно null, то нижней границы нет. Проверка границ здесь не выполняется; новое значение minimum может нарушить (minimum <= value <= maximum) инвариант, установленный конструкторами. Это упрощает обновление модели; естественно, необходимо убедиться, что инвариант верен перед вызовом методов getNextValue, getPreviousValue, или setValue.

Обычно этот параметр является Number того же типа, что и value, однако возможно использовать любой объект Comparable с методом compareTo для объекта Number того же типа, что и значение. Например, если значение было Long, то minimum может быть подклассом Date, определённым так:

 MyDate extends Date {  // Date already implements Comparable
     public int compareTo(Long o) {
         long t = getTime();
         return (t < o.longValue() ? -1 : (t == o.longValue() ? 0 : 1));
     }
 }

Этот метод вызывает ChangeEvent если minimum изменился.

Параметры:

minimum - Comparable с методом compareTo для Number того же типа, что и value

См. также:

getMinimum

public Comparable<?> getMinimum()

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

Возвращает:

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

См. также:

setMinimum(java.lang.Comparable<?>)

setMaximum

public void setMaximum(Comparable<?> maximum)

Изменяет верхнюю границу для чисел в этой последовательности. Если maximum равно null, то верхней границы нет. Проверка границ здесь не выполняется; новое значение maximum может нарушить (minimum <= value < maximum) инвариант, установленный конструкторами. Это упрощает обновление модели; естественно, необходимо убедиться, что инвариант верен перед вызовом методов next, previous, или setValue.

Обычно это свойство - Number того же типа, что и value, но можно использовать любой объект Comparable с методом compareTo для получения объекта Number того же типа, что и значение. См. setMinimum(Comparable) для примера.

Этот метод вызывает ChangeEvent если maximum изменился.

Параметры:

maximum - Comparable с методом compareTo для Number того же типа, что и value

См. также:

getMaximum

public Comparable<?> getMaximum()

Возвращает последнее число в последовательности.

Возвращает:

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

См. также:

setMaximum(java.lang.Comparable<?>)

setStepSize

public void setStepSize(Number stepSize)

Изменяет размер изменения значения, вычисляемого методами getNextValue и getPreviousValue. Генерируется IllegalArgumentException если stepSize равно null.

Этот метод вызывает ChangeEvent если stepSize изменилось.

Параметры:

stepSize - размер изменения значения, вычисляемого методами getNextValue и getPreviousValue

См. также:

getStepSize

public Number getStepSize()

Возвращает размер изменения значения, вычисляемого методами getNextValue и getPreviousValue.

Возвращает:

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

См. также:

setStepSize(java.lang.Number)

getNextValue

public Object getNextValue()

Возвращает следующее число в последовательности.

Определено в:

getNextValue в интерфейсе SpinnerModel

Возвращает:

value + stepSize или null если сумма превышает maximum

См. также:

SpinnerModel.getNextValue()
getPreviousValue()
setStepSize(java.lang.Number)

getPreviousValue

public Object getPreviousValue()

Возвращает предыдущее число в последовательности.

Определено в:

getPreviousValue в интерфейсе SpinnerModel

Возвращает:

value - stepSize, или null если сумма меньше minimum

См. также:

getNumber

public Number getNumber()

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

Возвращает:

свойство value

См. также:

setValue(java.lang.Object)

getValue

public Object getValue()

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

Указано в:

getValue в интерфейсе SpinnerModel

Возвращает:

свойство value

См. также:

setValue(java.lang.Object)
getNumber()

setValue

public void setValue(Object value)

Устанавливает текущее значение для этой последовательности. Если value имеет значение null, или не является Number, выбрасывается IllegalArgumentException. Проверка границ здесь не выполняется; новое значение может нарушить инвариант (minimum <= value <= maximum), накладываемый конструкторами. Также возможно установить значение, которое естественным образом не встречается в последовательности, т.е. значение, которое не является кратным stepSize. Это упрощает обновление модели и позволяет использовать спиннеры, которые не хотят ограничивать значения, введенные пользователем напрямую. Естественно, необходимо убедиться, что инвариант (minimum <= value <= maximum) верен перед вызовом методов next, previous, или setValue.

Этот метод срабатывает ChangeEvent, если значение изменилось.

Указано в:

setValue в интерфейсе SpinnerModel

Параметры:

value - текущее (не null) значение Number для этой последовательности

Исключения:

IllegalArgumentException - если value имеет значение null или не является Number

См. также:

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