Class DefaultBoundedRangeModel

protected ChangeEvent changeEvent

An event that is sent to all registered ChangeListeners when the state of this range model has changed.

The event object is created on demand, the first time it is actually needed.

See Also:

fireStateChanged()

protected EventListenerList listenerList

The list of the currently registered EventListeners.

public DefaultBoundedRangeModel()

Constructs a DefaultBoundedRangeModel with default values for the properties. The properties value, extent and minimum will be initialized to zero; maximum will be set to 100; the property valueIsAdjusting will be false.

public DefaultBoundedRangeModel(int value,
                                int extent,
                                int minimum,
                                int maximum)

Constructs a DefaultBoundedRangeModel with the specified values for some properties.

Parameters:

value - the initial value of the range model, which must be a number between minimum and (maximum - extent). In a scroll bar visualization of a BoundedRangeModel, the value is displayed as the position of the thumb.

extent - the initial extent of the range model, which is a number greater than or equal to zero. In a scroll bar visualization of a BoundedRangeModel, the extent is displayed as the size of the thumb.

minimum - the initial minimal value of the range model.

maximum - the initial maximal value of the range model.

Throws:

IllegalArgumentException - if the following condition is not satisfied: minimum <= value <= value + extent <= maximum.

public void addChangeListener(ChangeListener listener)

Subscribes a ChangeListener to state changes.

Specified by:

addChangeListener in interface BoundedRangeModel

Parameters:

listener - the listener to be subscribed.

public extends EventListener> T[] getListeners(Class listenerType)

Retrieves the current listeners of the specified class.

Parameters:

listenerType - the class of listeners; usually ChangeListener.class.

Returns:

an array with the currently subscribed listeners, or an empty array if there are currently no listeners.

Since:

1.3

protected void fireStateChanged()

Sends a ChangeEvent to any registered ChangeListeners.

See Also:

addChangeListener(ChangeListener), removeChangeListener(ChangeListener)

public ChangeListener[] getChangeListeners()

Returns all ChangeListeners that are currently subscribed for changes to this DefaultBoundedRangeModel.

Returns:

an array with the currently subscribed listeners, or an empty array if there are currently no listeners.

Since:

1.4

public int getExtent()

Returns the current extent of this bounded range model, which is a number greater than or equal to zero. In a scroll bar visualization of a BoundedRangeModel, the extent is displayed as the size of the thumb.

Specified by:

getExtent in interface BoundedRangeModel

Returns:

the extent

public int getMaximum()

Returns the current maximal value of this bounded range model.

Specified by:

getMaximum in interface BoundedRangeModel

Returns:

the maximum

public int getMinimum()

Returns the current minimal value of this bounded range model.

Specified by:

getMinimum in interface BoundedRangeModel

public int getValue()

Returns the current value of this bounded range model. In a scroll bar visualization of a BoundedRangeModel, the value is displayed as the position of the thumb.

Specified by:

getValue in interface BoundedRangeModel

Returns:

the value

public boolean getValueIsAdjusting()

Returns whether or not the value of this bounded range model is going to change in the immediate future. Scroll bars set this property to true while the thumb is being dragged around; when the mouse is relased, they set the property to false and post a final ChangeEvent.

Specified by:

getValueIsAdjusting in interface BoundedRangeModel

Returns:

true if the value will change soon again; false if the value will probably not change soon.

public void removeChangeListener(ChangeListener listener)

Cancels the subscription of a ChangeListener.

Specified by:

removeChangeListener in interface BoundedRangeModel

Parameters:

listener - the listener to be unsubscribed.

public void setExtent(int extent)

Changes the current extent of this bounded range model. In a scroll bar visualization of a BoundedRangeModel, the extent is displayed as the size of the thumb.

Specified by:

setExtent in interface BoundedRangeModel

Parameters:

extent - the new extent of the range model, which is a number greater than or equal to zero.

public void setMaximum(int maximum)

Changes the current maximal value of this bounded range model.

Specified by:

setMaximum in interface BoundedRangeModel

Parameters:

maximum - the new maximal value.

public void setMinimum(int minimum)

Changes the current minimal value of this bounded range model.

Specified by:

setMinimum in interface BoundedRangeModel

Parameters:

minimum - the new minimal value.

public void setRangeProperties(int value,
                               int extent,
                               int minimum,
                               int maximum,
                               boolean isAdjusting)

Sets all properties.

Specified by:

setRangeProperties in interface BoundedRangeModel

Parameters:

value - the new value of the range model. In a scroll bar visualization of a BoundedRangeModel, the value is displayed as the position of the thumb.

extent - the new extent of the range model, which is a number greater than or equal to zero. In a scroll bar visualization of a BoundedRangeModel, the extent is displayed as the size of the thumb.

minimum - the new minimal value of the range model.

maximum - the new maximal value of the range model.

isAdjusting - whether or not the value of this bounded range model is going to change in the immediate future. Scroll bars set this property to true while the thumb is being dragged around; when the mouse is relased, they set the property to false.

public void setValue(int value)

Changes the current value of this bounded range model. In a scroll bar visualization of a BoundedRangeModel, the value is displayed as the position of the thumb; changing the value of a scroll bar's model thus moves the thumb to a different position.

Specified by:

setValue in interface BoundedRangeModel

Parameters:

value - the value

public void setValueIsAdjusting(boolean isAdjusting)

Specifies whether or not the value of this bounded range model is going to change in the immediate future. Scroll bars set this property to true while the thumb is being dragged around; when the mouse is relased, they set the property to false.

Specified by:

setValueIsAdjusting in interface BoundedRangeModel

Parameters:

isAdjusting - true if the value will change soon again; false if the value will probably not change soon.

public String toString()

Returns a string with all relevant properties of this range model.

Overrides:

toString in interface Object

Returns:

a string representing the object