Класс SpinnerNumberModel

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

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

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

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

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

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

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

SpinnerNumberModel

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

Параметры:

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)

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

Параметры:

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

См. также:

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

getMinimum

public Comparable getMinimum()

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

Возвращает:

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

См. также:

setMinimum(java.lang.Comparable)

setMaximum

public void setMaximum(Comparable maximum)

Параметры:

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

См. также:

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

getMaximum

public Comparable getMaximum()

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

Возвращает:

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

См. также:

setMaximum(java.lang.Comparable)

setStepSize

public void setStepSize(Number stepSize)

Параметры:

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

См. также:

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

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.

См. также:

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

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)

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

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

Параметры:

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

Исключения:

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

См. также:

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