public class DefaultBoundedRangeModel extends Objectimplements BoundedRangeModel , Serializable
Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans™ has been added to the java.beans package. Please see XMLEncoder.
BoundedRangeModel
| Modifier and Type | Field and Description |
|---|---|
protected ChangeEvent |
changeEvent
Only one
ChangeEvent is needed per model instance since the event's only (read-only) state is the source property.
|
protected EventListenerList |
listenerList
The listeners waiting for model changes.
|
| Constructor and Description |
|---|
DefaultBoundedRangeModel()
Initializes all of the properties with default values.
|
DefaultBoundedRangeModel(int value, int extent, int min, int max)
Initializes value, extent, minimum and maximum.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addChangeListener(ChangeListener
Adds a
ChangeListener.
|
protected void |
fireStateChanged()
Runs each
ChangeListener's
stateChanged method.
|
ChangeListener |
getChangeListeners()
Returns an array of all the change listeners registered on this
DefaultBoundedRangeModel.
|
int |
getExtent()
Returns the model's extent.
|
<T extends EventListener |
getListeners(Class
Returns an array of all the objects currently registered as
FooListeners upon this model.
|
int |
getMaximum()
Returns the model's maximum.
|
int |
getMinimum()
Returns the model's minimum.
|
int |
getValue()
Returns the model's current value.
|
boolean |
getValueIsAdjusting()
Returns true if the value is in the process of changing as a result of actions being taken by the user.
|
void |
removeChangeListener(ChangeListener
Removes a
ChangeListener.
|
void |
setExtent(int n)
Sets the extent to
n after ensuring that
n is greater than or equal to zero and falls within the model's constraints:
|
void |
setMaximum(int n)
Sets the maximum to
n after ensuring that
n that the other three properties obey the model's constraints:
|
void |
setMinimum(int n)
Sets the minimum to
n after ensuring that
n that the other three properties obey the model's constraints:
|
void |
setRangeProperties(int newValue, int newExtent, int newMin, int newMax, boolean adjusting)
Sets all of the
BoundedRangeModel properties after forcing the arguments to obey the usual constraints:
|
void |
setValue(int n)
Sets the current value of the model.
|
void |
setValueIsAdjusting(boolean b)
Sets the
valueIsAdjusting property.
|
String |
toString()
Returns a string that displays all of the
BoundedRangeModel properties.
|
protected transient ChangeEventchangeEvent
ChangeEvent is needed per model instance since the event's only (read-only) state is the source property. The source of events generated here is always "this".
protected EventListenerListlistenerList
public DefaultBoundedRangeModel()
value = 0 extent = 0 minimum = 0 maximum = 100 adjusting = false public DefaultBoundedRangeModel(int value,
int extent,
int min,
int max)
IllegalArgumentException if the following constraints aren't satisfied:
min <= value <= value+extent <= max
public int getValue()
getValue in interface
BoundedRangeModel
setValue(int),
BoundedRangeModel.getValue()
public int getExtent()
getExtent in interface
BoundedRangeModel
setExtent(int),
BoundedRangeModel.getExtent()
public int getMinimum()
getMinimum in interface
BoundedRangeModel
setMinimum(int),
BoundedRangeModel.getMinimum()
public int getMaximum()
getMaximum in interface
BoundedRangeModel
setMaximum(int),
BoundedRangeModel.getMaximum()
public void setValue(int n)
minimum <= value <= value+extent <= maximum
setValue in interface
BoundedRangeModel
n - the model's new value
BoundedRangeModel.setValue(int)
public void setExtent(int n)
minimum <= value <= value+extent <= maximum
setExtent in interface
BoundedRangeModel
n - the model's new extent
BoundedRangeModel.setExtent(int)
public void setMinimum(int n)
minimum <= value <= value+extent <= maximum
setMinimum in interface
BoundedRangeModel
n - the model's new minimum
getMinimum(),
BoundedRangeModel.setMinimum(int)
public void setMaximum(int n)
minimum <= value <= value+extent <= maximum
setMaximum in interface
BoundedRangeModel
n - the model's new maximum
BoundedRangeModel.setMaximum(int)
public void setValueIsAdjusting(boolean b)
valueIsAdjusting property.
setValueIsAdjusting in interface
BoundedRangeModel
b - true if the upcoming changes to the value property are part of a series
getValueIsAdjusting(),
setValue(int),
BoundedRangeModel.setValueIsAdjusting(boolean)
public boolean getValueIsAdjusting()
getValueIsAdjusting in interface
BoundedRangeModel
valueIsAdjusting property
setValue(int),
BoundedRangeModel.getValueIsAdjusting()
public void setRangeProperties(int newValue,
int newExtent,
int newMin,
int newMax,
boolean adjusting)
BoundedRangeModel properties after forcing the arguments to obey the usual constraints:
minimum <= value <= value+extent <= maximum
At most, one ChangeEvent is generated.
setRangeProperties in interface
BoundedRangeModel
newValue - an int giving the current value
newExtent - an int giving the amount by which the value can "jump"
newMin - an int giving the minimum value
newMax - an int giving the maximum value
adjusting - a boolean, true if a series of changes are in progress
BoundedRangeModel.setRangeProperties(int, int, int, int, boolean) ,
setValue(int),
setExtent(int),
setMinimum(int),
setMaximum(int),
setValueIsAdjusting(boolean)
public void addChangeListener(ChangeListenerl)
ChangeListener. The change listeners are run each time any one of the Bounded Range model properties changes.
addChangeListener in interface
BoundedRangeModel
l - the ChangeListener to add
removeChangeListener(javax.swing.event.ChangeListener),
BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)
public void removeChangeListener(ChangeListenerl)
ChangeListener.
removeChangeListener in interface
BoundedRangeModel
l - the
ChangeListener to remove
addChangeListener(javax.swing.event.ChangeListener),
BoundedRangeModel.removeChangeListener(javax.swing.event.ChangeListener)
public ChangeListener[] getChangeListeners()
DefaultBoundedRangeModel.
ChangeListeners or an empty array if no change listeners are currently registered
addChangeListener(javax.swing.event.ChangeListener),
removeChangeListener(javax.swing.event.ChangeListener)
protected void fireStateChanged()
ChangeListener's
stateChanged method.
public StringtoString()
BoundedRangeModel properties.
public <T extends EventListener> T[] getListeners(Class <T> listenerType)
FooListeners upon this model.
FooListeners are registered using the
addFooListener method.
You can specify the listenerType argument with a class literal, such as FooListener.class. For example, you can query a DefaultBoundedRangeModel instance m for its change listeners with the following code:
ChangeListener[] cls = (ChangeListener[])(m.getListeners(ChangeListener.class));If no such listeners exist, this method returns an empty array.
listenerType - the type of listeners requested; this parameter should specify an interface that descends from
java.util.EventListener
FooListeners on this model, or an empty array if no such listeners have been added
ClassCastException - if
listenerType doesn't specify a class or interface that implements
java.util.EventListener
getChangeListeners()