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

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 의 값이, constructor 에 의해 적용되는 불변식 (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 의 값이, constructor 에 의해 적용되는 불변식 (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 가 슬로우 됩니다. 여기에서는 경계의 체크는 행해지지 않습니다. 즉, 새로운 값이, constructor 에 의해 적용되는 불변식 (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)