javax.swing
클래스 SpinnerNumberModel

java.lang.Object 
  javax.swing.AbstractSpinnerModel 
      javax.swing.SpinnerNumberModel

모든 구현된 인터페이스:

Serializable, SpinnerModel

public class SpinnerNumberModel
extends AbstractSpinnerModel 
implements Serializable 

수치의 순서를 나타내는 SpinnerModel 입니다. 순서의 상한과 하한은, minimum 및 maximum 라고 하는 프로퍼티에 의해 정의합니다. nextValue 메서드와 previousValue 메서드에 의해 계산되는 증가분 또는 감소분은, stepSize 라고 하는 프로퍼티에 의해 정의합니다. 순서에 상한 또는 하한이 없는 것을 나타내기 위해서 minimum 프로퍼티 또는 maximum 프로퍼티를 null로 할 수 있습니다. 이 클래스의 프로퍼티는 모두, Number 및 Comparable 라고 하는 2개의 범용형에 의해 정의하기 위해, Java 수치형의 모두에게 대응할 수 있습니다. 내부적으로는 기본적인 Number 형을 가지는 값, 즉, Double, Float, Long, Integer, Short, Byte 어떤 것인가의 형태를 가지는 값 밖에 지원 하고 있습니다.

초기값이 50 으로 0 ~ 100 정수를 나타내는 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();
 

Integer 형과 Double 형의 스피나-가 일반적이어서, 이러한 형태에 대응한 전용의 생성자가 준비되어 있습니다. 예를 들어 전의 예의 모델을 작성하는 경우, 다음과 같이 기술할 수도 있습니다.

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

이 모델은 ChangeListener를 상속합니다. 모델의 value, stepSize, minimum, maximum 각 프로퍼티가 변경되었을 때에는 ChangeListeners 으로 변경이 통지됩니다.

도입된 버전 :

1.4

관련 항목:

JSpinner, SpinnerModel, AbstractSpinnerModel, SpinnerListModel, SpinnerDateModel

필드 개요

클래스 javax.swing. AbstractSpinnerModel 로부터 상속된 필드

listenerList

생성자 개요

SpinnerNumberModel ()
minimum 및 maximum값을 지정하지 않고, stepSize를 1, 초기값을 0 으로의해 SpinnerNumberModel을 구축합니다.

SpinnerNumberModel (double value, double minimum, double maximum, double stepSize)
지정된 value, 경계 (minimum/maximum) 및 stepSize로 SpinnerNumberModel을 구축합니다.

SpinnerNumberModel (int value, int minimum, int maximum, int stepSize)
지정된 value, 경계 (minimum/maximum) 및 stepSize로 SpinnerNumberModel을 구축합니다.

SpinnerNumberModel (Number value, Comparable minimum, Comparable maximum, Number stepSize)
minimum로 부터 maximum 까지의 수치로부터 완성되는 닫은 순서를 나타내는 SpinnerModel을 구축합니다.

메서드 개요

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)

minimum로 부터 maximum 까지의 수치로부터 완성되는 닫은 순서를 나타내는 SpinnerModel을 구축합니다. nextValue 메서드와 previousValue 메서드는 stepSize를 가산 또는 감산해, 순서의 요소를 계산합니다. 파라미터는 모두, 서로 Comparable 일 필요가 있어, value와 stepSize는 Integer, Long, Float, 또는 Double 인스턴스일 필요가 있습니다.

순서의 범위에 상한 또는 하한이 없는 것을 나타내기 위해서 minimum 파라미터와 maximum 파라미터를 null로 할 수 있습니다. value 또는 stepSize가 null인 경우, 혹은 minimum와 maximum 양쪽 모두가 지정되고 있어mininum > maximum인 경우, IllegalArgumentException가 발생 됩니다. 같이(minimum <= value <= maximum)가 false인 경우도, IllegalArgumentException가 발생 됩니다.

파라미터:

value - 모델의 현재의 값 (null 이외)

minimum - 순서의 선두의 수치 또는 null

maximum - 순서의 마지막 수치 또는 null

stepSize - 순서의 요소간의 차이

예외:

IllegalArgumentException - stepSize 또는 value가 null인 경우, 혹은 minimum <= value <= maximum가 false인 경우

SpinnerNumberModel

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

지정된 value, 경계 (minimum/maximum) 및 stepSize로 SpinnerNumberModel을 구축합니다.

파라미터:

value - 모델의 현재가

minimum - 순서의 선두의 수치

maximum - 순서의 마지막 수치

stepSize - 순서의 요소간의 차이

예외:

IllegalArgumentException - minimum <= value <= maximum가 false인 경우

SpinnerNumberModel

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

지정된 value, 경계 (minimum/maximum) 및 stepSize로 SpinnerNumberModel을 구축합니다.

파라미터:

value - 모델의 현재가

minimum - 순서의 선두의 수치

maximum - 순서의 마지막 수치

stepSize - 순서의 요소간의 차이

예외:

IllegalArgumentException - minimum <= value <= maximum가 false인 경우

SpinnerNumberModel

public SpinnerNumberModel()

minimum 및 maximum값을 지정하지 않고, stepSize를 1, 초기값을 0 으로의해 SpinnerNumberModel을 구축합니다.

메서드의 상세

setMinimum

public void setMinimum(Comparable  minimum)

이 순서의 수치의 하한을 변경합니다. minimum가 null인 경우, 하한은 없습니다. 여기에서는 경계의 체크는 행해지지 않습니다. 즉, 새로운 minimum값이, 생성자에 의해 적용되는 불변식 (minimum <= value <= maximum)을 무효로 하는 일이 있습니다. 이것은 모델의 갱신을 단순하게 하기 때문에입니다. 당연, getNextValue, getPreviousValue, setValue 각 메서드를 호출하기 전에 불변식이 true가 되도록 할 필요가 있습니다.

보통, 이 프로퍼티는 value와 같은 형태의 Number 입니다만, Comparable로 value와 같은 형태의 Number에 대한 compareTo 메서드를 사용할 수 있습니다. 예를 들어 value가 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));
     }
 }
 

minimum가 변경되면, 이 메서드는 ChangeEvent를 트리거 합니다.

파라미터:

minimum - value와 같은 형태의 Number에 대한 compareTo 메서드를 가지는 Comparable

관련 항목:

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가 null인 경우, 상한은 없습니다. 여기에서는 경계의 체크는 행해지지 않습니다. 즉, 새로운 maximum값이, 생성자에 의해 적용되는 불변식 (minimum <= value <= maximum)을 무효로 하는 일이 있습니다. 이것은 모델의 갱신을 단순하게 하기 때문에입니다. 당연, next, previous, setValue 각 메서드를 호출하기 전에 불변식이 true가 되도록 할 필요가 있습니다.

보통, 이 프로퍼티는 value와 같은 형태의 Number 입니다만, Comparable로 value와 같은 형태의 Number에 대한 compareTo 메서드를 사용할 수 있습니다. 예에 대해서는 setMinimum 를 참조하십시오.

maximum가 변경되면, 이 메서드는 ChangeEvent를 트리거 합니다.

파라미터:

maximum - value와 같은 형태의 Number에 대한 compareTo 메서드를 가지는 Comparable

관련 항목:

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)

getNextValue 메서드와 getPreviousValue 메서드에 의해 계산되는 값변경의 사이즈를 변경합니다. stepSize가 null인 경우, IllegalArgumentException가 발생 됩니다.

stepSize가 변경되면, 이 메서드는 ChangeEvent를 트리거 합니다.

파라미터:

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

순서의 다음의 수치를 리턴합니다.

정의:

인터페이스 SpinnerModel 내의 getNextValue

반환값:

value + stepSize. 이 값이 maximum를 넘는 경우는 null

관련 항목:

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

getPreviousValue

public Object  getPreviousValue()

순서의 전의 수치를 리턴합니다.

정의:

인터페이스 SpinnerModel 내의 getPreviousValue

반환값:

value - stepSize. 이 값이 minimum를 밑도는 경우는 null

관련 항목:

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

getNumber

public Number  getNumber()

순서의 현재의 요소의 값을 리턴합니다.

반환값:

value 프로퍼티

관련 항목:

setValue(java.lang.Object)

getValue

public Object  getValue()

순서의 현재의 요소의 값을 리턴합니다.

정의:

인터페이스 SpinnerModel 내의 getValue

반환값:

value 프로퍼티

관련 항목:

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

setValue

public void setValue(Object  value)

이 순서의 현재가를 설정합니다. value가 null인 경우, 혹은 Number가 아닌 경우, IllegalArgumentException가 발생 됩니다. 여기에서는 경계의 체크는 행해지지 않습니다. 즉, 새로운 값이, 생성자에 의해 적용되는 불변식 (minimum <= value <= maximum)을 무효로 하는 일이 있습니다. 순서로 일어날 수 없는 값, 즉 stepSize 모듈로가 아닌 값에 value를 설정할 가능성도 있습니다. 이것은 모델의 갱신을 단순하게 하기 위한(해)여, 사용자가 직접 입력한 값에 제한을 더하지 않는 스피나-에 대응하기 위해이기도 합니다. 당연, next, previous, setValue 각 메서드를 호출하기 전에 불변식 (minimum <= value <= maximum) 이 true가 되도록 할 필요가 있습니다.

value가 변경되면, 이 메서드는 ChangeEvent를 트리거 합니다.

정의:

인터페이스 SpinnerModel 내의 setValue

파라미터:

value - 이 순서의 현재의 Number (null 이외)

예외:

IllegalArgumentException - value가 null인 경우, 혹은 Number가 아닌 경우

관련 항목:

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