javax.swing
인터페이스 BoundedRangeModel

기존의 구현 클래스의 일람:

DefaultBoundedRangeModel

public interface BoundedRangeModel

Slider 나 ProgressBar 등의 컴퍼넌트가 사용하는 데이터 모델을 정의합니다. 4 개(살)의 서로 관련한 정수형의 프로퍼티 minimum, maximum, extent, 및 value 를 정의합니다. 이러한 정수는, 상자가 된 2 개의 범위를 다음과 같이 해 정의합니다.

 minimum <= value <= value+extent <= maximum
 

외측의 범위는 minimum,maximum 로, 안쪽의 범위는 value,value+extent 가 됩니다. 안쪽의 범위는, 외측의 범위내에 들어가지 않으면 안됩니다. 즉,value 의 값은 maximum 의 값이하가 아니면 안되어,value+extent 의 값은,minimum 의 값이상,maximum 의 값은 minimum 이상이 아니면 안됩니다. 이 모델의 몇개의 기능은 조금 이질의 것입니다. 이것들은,Slider 나 ScrollBar 와 같은 Swing 의 BoundedRangeModel 클라이언트를 위해서(때문에) 존재하고 있습니다.

• minimum 및 maximum 설정 메소드는, 다른 3 개의 프로퍼티을, 새로운 값의 인수에 맞춥니다. 예를 들어, 모델의 minimum 를 설정하면(자), maximum, value, 및 extent 프로퍼티이 설정된 순서로 변경되어 전술한 조건을 유지합니다.
• value 및 extent 설정 메소드는, 다른 3 개의 프로퍼티에 의해 정의된 제한으로 인수를 맞춥니다. 예를 들어,value == maximum 의 경우,setExtent(10) 는 extent 를 제로에 되돌립니다.
• BoundedRangeModel 의 4 개의 값은 Java Beans 의 프로퍼티으로서 정의되고 있습니다만, Swing 의 ChangeEvent 는, PropertyChangeEvent 보다 변경을 클라이언트에 통지하는 용도에 자주(잘) 사용됩니다. 이것에 의해, BoundRangeModel 를 감시하는 오버헤드를 낮게 유지할 수가 있습니다. 변경은, 자주 MouseDragged 의 레이트의 형태로 리포트됩니다.

슬라이더에 의해 커스텀 한계 범위 모델을 지정하는 예는, 「The Java Tutorial」의 「The Anatomy of a Swing-Based Program」를 참조해 주세요.

관련 항목:

DefaultBoundedRangeModel

메소드의 개요

void	addChangeListener (ChangeListener x) 모델의 청취자 리스트에 ChangeListener 를 추가합니다.
int	getExtent () 모델의 extent 의 값, 즉, 모델의 value 로부터 시작되는 안쪽의 범위의 길이를 돌려줍니다.
int	getMaximum () 모델의 maximum 를 돌려줍니다.
int	getMinimum () minimum 에 사용할 수 있는 값을 돌려줍니다.
int	getValue () 모델의 현재의 값을 돌려줍니다.
boolean	getValueIsAdjusting () value 프로퍼티에의 현재의 변경이, 일련의 변경의 일부인 경우에 true 를 돌려줍니다.
void	removeChangeListener (ChangeListener x) 모델의 청취자 리스트로부터 ChangeListener 를 삭제합니다.
void	setExtent (int newExtent) 모델의 extent 의 값을 설정합니다.
void	setMaximum (int newMaximum) 모델의 maximum 를 newMaximum 로 설정합니다.
void	setMinimum (int newMinimum) 모델의 minimum 를 newMinimum 로 설정합니다.
void	setRangeProperties (int value, int extent, int min, int max, boolean adjusting) 1 회의 메소드의 호출로, 모델의 데이터를 모두 설정할 수 있는 메소드입니다.
void	setValue (int newValue) newValue 가 모델의 조건식을 채우는 경우는, 모델의 현재의 값을 newValue 로 설정합니다.
void	setValueIsAdjusting (boolean b) 모델의 값에 대한 변경을 단일의 이벤트로서 취급하는 것을 나타내는 속성입니다.

메소드의 상세

getMinimum

int getMinimum()

minimum 에 사용할 수 있는 값을 돌려줍니다.

반환값:

minimum 프로퍼티의 값

관련 항목:

setMinimum(int)

setMinimum

void setMinimum(int newMinimum)

모델의 minimum 를 newMinimum 로 설정합니다. 거기에 응해 다른 3 개의 프로퍼티도 다음의 조건식을 채우도록(듯이) 변경됩니다.

 minimum <= value <= value+extent <= maximum
 

모델이 변경되었을 경우, 모든 청취자에게 통지됩니다.

파라미터:

newMinimum - 모델의 새로운 minimum

관련 항목:

getMinimum() , addChangeListener(javax.swing.event.ChangeListener)

getMaximum

int getMaximum()

모델의 maximum 를 돌려줍니다. 모델의 값의 상한은 (maximum - extent)인 점에 주의해 주세요.

반환값:

maximum 프로퍼티의 값

관련 항목:

setMaximum(int) , setExtent(int)

setMaximum

void setMaximum(int newMaximum)

모델의 maximum 를 newMaximum 로 설정합니다. 거기에 응해 다른 3 개의 프로퍼티도 다음의 조건식을 채우도록(듯이) 변경됩니다.

 minimum <= value <= value+extent <= maximum
 

모델이 변경되었을 경우, 모든 청취자에게 통지됩니다.

파라미터:

newMaximum - 모델의 새로운 maximum

관련 항목:

getMaximum() , addChangeListener(javax.swing.event.ChangeListener)

getValue

int getValue()

모델의 현재의 값을 돌려줍니다. 모델의 값의 상한은 maximum - extent 이며, 하한은 minimum 인 점에 주의해 주세요.

반환값:

모델의 값

관련 항목:

setValue(int)

setValue

void setValue(int newValue)

newValue 가 모델의 조건식을 채우는 경우는, 모델의 현재의 값을 newValue 로 설정합니다. 조건식은 다음과 같습니다.

 minimum <= value <= value+extent <= maximum
 

그 이외의 경우는,newValue 가 minimum 보다 작은 경우, 모델의 현재의 값은 minimum 로 설정됩니다. maximum 보다 큰 경우는,maximum 로 설정됩니다. value+extent 보다 큰 경우는,value+extent 로 설정됩니다.

value+extent 보다 큰 경우는,value+extent 로 설정됩니다. BoundedRange 모델이 스크롤 바에 사용되고 있을 때, 이 값은 「안주」또는 「슬라이더」라고도 불리는 스크롤 바의 노브의 원점을 지정합니다. 일반적으로 이 값은, 스크롤 되는 객체의 가시 부분의 원점을 나타냅니다.

모델이 변경되었을 경우, 모든 청취자에게 통지됩니다.

파라미터:

newValue - 모델의 새로운 값

관련 항목:

getValue()

setValueIsAdjusting

void setValueIsAdjusting(boolean b)

모델의 값에 대한 변경을 단일의 이벤트로서 취급하는 것을 나타내는 속성입니다. 값으로 일련의 변경이 더해지기 전에, 이 값을 true 로 설정합니다. 변경이 종료하면(자), 값을 false 로 설정합니다. 일반적으로의 사용법에서는, 값의 최종적인 변경이 확정되었을 경우에게만, 청취자가 액션을 실행하도록(듯이) 합니다. 이것으로, 변경중의 과도기적인 값에 대응하는 갱신이 불필요하게 됩니다.

슬라이더와 스크롤 바는, 드래그중에 이 프로퍼티을 사용합니다.

파라미터:

b - value 프로퍼티에의 변경을, 일련의 변경의 일부로 하는 경우는 true

getValueIsAdjusting

boolean getValueIsAdjusting()

value 프로퍼티에의 현재의 변경이, 일련의 변경의 일부인 경우에 true 를 돌려줍니다.

반환값:

valueIsAdjustingProperty

관련 항목:

setValueIsAdjusting(boolean)

getExtent

int getExtent()

모델의 extent 의 값, 즉, 모델의 value 로부터 시작되는 안쪽의 범위의 길이를 돌려줍니다.

반환값:

모델의 extent 프로퍼티의 값

관련 항목:

setExtent(int) , setValue(int)

setExtent

void setExtent(int newExtent)

모델의 extent 의 값을 설정합니다. newExtent 의 경우는, 제로 이상으로, maximum - value 이하의 값을 설정할 필요가 있습니다.

BoundedRange 모델이 스크롤 바에 사용되고 있을 때, extent 는 「안주」또는 「슬라이더」라고도 불리는 스크롤 바의 노브의 길이를 정의합니다. 일반적으로, extent 는, 스크롤 되는 객체 가운데 가시가 되는 부분의 양을 나타냅니다. 슬라이더에 사용하는 경우, extent 는 그 값만 「점프」하는 양을 나타냅니다. 예를 들어, PgUp 나 PgDn 키를 눌렀을 경우의 스크롤량입니다.

모델이 변경되었을 경우, 모든 청취자에게 통지됩니다.

파라미터:

newExtent - 모델의 새로운 extent

관련 항목:

getExtent() , setValue(int)

setRangeProperties

void setRangeProperties(int value,
                        int extent,
                        int min,
                        int max,
                        boolean adjusting)

1 회의 메소드의 호출로, 모델의 데이터를 모두 설정할 수 있는 메소드입니다. 그 결과, 단일의 변경 이벤트가 생성됩니다. 개개의 변경 이벤트를 발생시키지 않고 , 모델의 데이터를 모두 동시에 조정하는데 편리합니다.

파라미터:

value - 현재의 값을 지정하는 정수치

extent - 치가 「점프」할 수 있는 양을 지정하는 정수치

min - 최소치를 지정하는 정수치

max - 최대치를 지정하는 정수치

adjusting - boolean 치. 일련의 변경이 진행중인 경우는 true

관련 항목:

setValue(int) , setExtent(int) , setMinimum(int) , setMaximum(int) , setValueIsAdjusting(boolean)

addChangeListener

void addChangeListener(ChangeListener  x)

모델의 청취자 리스트에 ChangeListener 를 추가합니다.

파라미터:

x - 추가하는 ChangeListener

관련 항목:

removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

void removeChangeListener(ChangeListener  x)

모델의 청취자 리스트로부터 ChangeListener 를 삭제합니다.

파라미터:

x - 삭제하는 ChangeListener

관련 항목:

addChangeListener(javax.swing.event.ChangeListener)