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 으로 설정됩니다.

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)