|
JavaTM 2 Platform Std. Ed. v1.4.2 |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Objectjavax.swing.AbstractSpinnerModel
javax.swing.SpinnerListModel
A simple implementation of SpinnerModel whose
values are defined by an array or a List.
For example to create a model defined by
an array of the names of the days of the week:
String[] days = new DateFormatSymbols().getWeekdays(); SpinnerModel model = new SpinnerListModel(Arrays.asList(days).subList(1, 8));This class only stores a reference to the array or
List
so if an element of the underlying sequence changes, it's up
to the application to notify the ChangeListeners by calling
fireStateChanged.
This model inherits a ChangeListener.
The ChangeListeners are notified whenever the
model's value or list properties changes.
JSpinner,
SpinnerModel,
AbstractSpinnerModel,
SpinnerNumberModel,
SpinnerDateModel| Field Summary |
| Fields inherited from class javax.swing.AbstractSpinnerModel |
listenerList |
| Constructor Summary | |
SpinnerListModel()
Constructs an effectively empty SpinnerListModel. |
|
SpinnerListModel(List values)
Constructs a SpinnerModel whose sequence of
values is defined by the specified List. |
|
SpinnerListModel(Object[] values)
Constructs a SpinnerModel whose sequence of values
is defined by the specified array. |
|
| Method Summary | |
List |
getList()
Returns the List that defines the sequence for this model. |
Object |
getNextValue()
Returns the next legal value of the underlying sequence or null if value is already the last element. |
Object |
getPreviousValue()
Returns the previous element of the underlying sequence or null if value is already the first element. |
Object |
getValue()
Returns the current element of the sequence. |
void |
setList(List list)
Changes the list that defines this sequence and resets the index of the models value to zero. |
void |
setValue(Object elt)
Changes the current element of the sequence and notifies ChangeListeners. |
| Methods inherited from class javax.swing.AbstractSpinnerModel |
addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
public SpinnerListModel(List values)
SpinnerModel whose sequence of
values is defined by the specified List.
The initial value (current element)
of the model will be values.get(0).
If values is null or has zero
size, an IllegalArugmentException is thrown.
values - the sequence this model represents
IllegalArugmentException - if values is
null or zero sizepublic SpinnerListModel(Object[] values)
SpinnerModel whose sequence of values
is defined by the specified array. The initial value of the model
will be values[0]. If values is
null or has zero length, an
IllegalArugmentException is thrown.
values - the sequence this model represents
IllegalArugmentException - if values is
null or zero lengthpublic SpinnerListModel()
SpinnerListModel.
The model's list will contain a single
"empty" string element.
| Method Detail |
public List getList()
List that defines the sequence for this model.
list propertysetList(java.util.List)public void setList(List list)
value to zero. Note that list
is not copied, the model just stores a reference to it.
This method fires a ChangeEvent if list is
not equal to the current list.
list - the sequence that this model represents
IllegalArgumentException - if list is
null or zero lengthgetList()public Object getValue()
getValue in interface SpinnerModelvalue propertySpinnerModel.getValue(),
setValue(java.lang.Object)public void setValue(Object elt)
ChangeListeners. If the specified
value is not equal to an element of the underlying sequence
then an IllegalArgumentException is thrown.
In the following example the setValue call
would cause an exception to be thrown:
String[] values = {"one", "two", "free", "four"};
SpinnerModel model = new SpinnerListModel(values);
model.setValue("TWO");
setValue in interface SpinnerModelelt - the sequence element that will be model's current value
IllegalArgumentException - if the specified value isn't allowedSpinnerModel.setValue(java.lang.Object),
getValue()public Object getNextValue()
null if value is already the last element.
getNextValue in interface SpinnerModelnull if value is already the last elementSpinnerModel.getNextValue(),
getPreviousValue()public Object getPreviousValue()
null if value is already the first element.
getPreviousValue in interface SpinnerModelnull if value is already the first elementSpinnerModel.getPreviousValue(),
getNextValue()
|
JavaTM 2 Platform Std. Ed. v1.4.2 |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.