javax.swing

Класс SpinnerNumberModel

java.lang. Объект

javax.swing. AbstractSpinnerModel

javax.swing. SpinnerNumberModel

Все Реализованные Интерфейсы:

Сериализуемый, SpinnerModel

public class SpinnerNumberModel
extends AbstractSpinnerModel
implements Serializable

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

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

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

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

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

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

С тех пор:

1.4

См. Также:

JSpinner, SpinnerModel, AbstractSpinnerModel, SpinnerListModel, SpinnerDateModel

Полевая Сводка

Поля javax.swing унаследованный от класса. AbstractSpinnerModel

listenerList

Сводка конструктора

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

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

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Сопоставимый	getMaximum() Возвращает последнее число в последовательности.
Сопоставимый	getMinimum() Возвращает первое число в этой последовательности.
Объект	getNextValue() Возвращает следующее число в последовательности.
Число	getNumber() Возвращает значение текущего элемента последовательности.
Объект	getPreviousValue() Возвращает предыдущее число в последовательности.
Число	getStepSize() Возвращает размер изменения значения, вычисленного getNextValue и getPreviousValue методы.
Объект	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 унаследованный от класса. Объект

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

Деталь конструктора

SpinnerNumberModel

public SpinnerNumberModel(Number value,
                  Comparable minimum,
                  Comparable maximum,
                  Number stepSize)

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

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

Параметры:

value - ток (нет null) значение модели

minimum - первое число в последовательности или null

maximum - последнее число в последовательности или null

stepSize - различие между элементами последовательности

Броски:

IllegalArgumentException - если stepSize или значение null или если следующее выражение является ложью: minimum <= value <= maximum

SpinnerNumberModel

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

Конструкции a SpinnerNumberModel с указанным value, minimum/maximum границы, и stepSize.

Параметры:

value - текущая стоимость модели

minimum - первое число в последовательности

maximum - последнее число в последовательности

stepSize - различие между элементами последовательности

Броски:

IllegalArgumentException - если следующее выражение является ложью: minimum <= value <= maximum

SpinnerNumberModel

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

Конструкции a SpinnerNumberModel с указанным value, minimum/maximum границы, и stepSize.

Параметры:

value - текущая стоимость модели

minimum - первое число в последовательности

maximum - последнее число в последовательности

stepSize - различие между элементами последовательности

Броски:

IllegalArgumentException - если следующее выражение является ложью: minimum <= value <= maximum

SpinnerNumberModel

public SpinnerNumberModel()

Конструкции a SpinnerNumberModel без minimum или maximum значение, stepSize равный одному, и начальному значению нуля.

Деталь метода

setMinimum

public void setMinimum(Comparable minimum)

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

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

 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));
     }
 }
 

This method fires a ChangeEvent if the minimum has changed.

Parameters:

minimum - a Comparable that has a compareTo method for Numbers with the same type as value

See Also:

getMinimum(), setMaximum(java.lang.Comparable), SpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

getMinimum

public Comparable getMinimum()

Returns the first number in this sequence.

Returns:

the value of the minimum property

See Also:

setMinimum(java.lang.Comparable)

setMaximum

public void setMaximum(Comparable maximum)

Changes the upper bound for numbers in this sequence. If maximum is null, then there is no upper bound. No bounds checking is done here; the new maximum value may invalidate the (minimum <= value < maximum) invariant enforced by the constructors. This is to simplify updating the model, naturally one should ensure that the invariant is true before calling the next, previous, or setValue methods.

Typically this property is a Number of the same type as the value however it's possible to use any Comparable with a compareTo method for a Number with the same type as the value. See setMinimum for an example.

This method fires a ChangeEvent if the maximum has changed.

Parameters:

maximum - a Comparable that has a compareTo method for Numbers with the same type as value

See Also:

getMaximum(), setMinimum(java.lang.Comparable), SpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

getMaximum

public Comparable getMaximum()

Returns the last number in the sequence.

Returns:

the value of the maximum property

See Also:

setMaximum(java.lang.Comparable)

setStepSize

public void setStepSize(Number stepSize)

Changes the size of the value change computed by the getNextValue and getPreviousValue methods. An IllegalArgumentException is thrown if stepSize is null.

This method fires a ChangeEvent if the stepSize has changed.

Parameters:

stepSize - the size of the value change computed by the getNextValue and getPreviousValue methods

See Also:

getNextValue(), getPreviousValue(), getStepSize(), SpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

getStepSize

public Number getStepSize()

Returns the size of the value change computed by the getNextValue and getPreviousValue methods.

Returns:

the value of the stepSize property

See Also:

setStepSize(java.lang.Number)

getNextValue

public Object getNextValue()

Returns the next number in the sequence.

Specified by:

getNextValue in interface SpinnerModel

Returns:

value + stepSize or null if the sum exceeds maximum.

See Also:

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

getPreviousValue

public Object getPreviousValue()

Returns the previous number in the sequence.

Specified by:

getPreviousValue in interface SpinnerModel

Returns:

value - stepSize, or null if the sum is less than minimum.

See Also:

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

getNumber

public Number getNumber()

Returns the value of the current element of the sequence.

Returns:

the value property

See Also:

setValue(java.lang.Object)

getValue

public Object getValue()

Returns the value of the current element of the sequence.

Specified by:

getValue in interface SpinnerModel

Returns:

the value property

See Also:

setValue(java.lang.Object), getNumber()

setValue

public void setValue(Object value)

Sets the current value for this sequence. If value is null, or not a Number, an IllegalArgumentException is thrown. No bounds checking is done here; the new value may invalidate the (minimum <= value <= maximum) invariant enforced by the constructors. It's also possible to set the value to be something that wouldn't naturally occur in the sequence, i.e. a value that's not modulo the stepSize. This is to simplify updating the model, and to accommodate spinners that don't want to restrict values that have been directly entered by the user. Naturally, one should ensure that the (minimum <= value <= maximum) invariant is true before calling the next, previous, or setValue methods.

This method fires a ChangeEvent if the value has changed.

Specified by:

setValue in interface SpinnerModel

Parameters:

value - the current (non null) Number for this sequence

Throws:

IllegalArgumentException - if value is null or not a Number

See Also:

getNumber(), getValue(), SpinnerModel.addChangeListener(javax.swing.event.ChangeListener)