File	Doc	Category	Size	Date	Package
SpinnerListModel.java	API Doc	Java SE 5 API	7139	Fri Aug 26 14:57:58 BST 2005	javax.swing

SpinnerListModel

• java.lang.Object
  • javax.swing.AbstractSpinnerModel

String[] days = new DateFormatSymbols().getWeekdays();
SpinnerModel model = new SpinnerListModel(Arrays.asList(days).subList(1, 8));

Fields Summary
private List	list
private int	index

Constructors Summary
public SpinnerListModel(List values) Constructs a 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. param values the sequence this model represents throws IllegalArugmentException if values is null or zero size if (values == null || values.size() == 0) { throw new IllegalArgumentException("SpinnerListModel(List) expects non-null non-empty List"); } this.list = values; this.index = 0;
public SpinnerListModel(Object[] values) Constructs a 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. param values the sequence this model represents throws IllegalArugmentException if values is null or zero length if (values == null || values.length == 0) { throw new IllegalArgumentException("SpinnerListModel(Object[]) expects non-null non-empty Object[]"); } this.list = Arrays.asList(values); this.index = 0;
public SpinnerListModel() Constructs an effectively empty SpinnerListModel. The model's list will contain a single "empty" string element. this(new Object[]{"empty"});

Methods Summary
java.lang.Object	findNextMatch(java.lang.String substring) Returns the next object that starts with substring. param substring the string to be matched return the match int max = list.size(); if (max == 0) { return null; } int counter = index; do { Object value = list.get(counter); String string = value.toString(); if (string != null && string.startsWith(substring)) { return value; } counter = (counter + 1) % max; } while (counter != index); return null;
public java.util.List	getList() Returns the List that defines the sequence for this model. return the value of the list property see #setList return list;
public java.lang.Object	getNextValue() Returns the next legal value of the underlying sequence or null if value is already the last element. return the next legal value of the underlying sequence or null if value is already the last element see SpinnerModel#getNextValue see #getPreviousValue return (index >= (list.size() - 1)) ? null : list.get(index + 1);
public java.lang.Object	getPreviousValue() Returns the previous element of the underlying sequence or null if value is already the first element. return the previous element of the underlying sequence or null if value is already the first element see SpinnerModel#getPreviousValue see #getNextValue return (index <= 0) ? null : list.get(index - 1);
public java.lang.Object	getValue() Returns the current element of the sequence. return the value property see SpinnerModel#getValue see #setValue return list.get(index);
public void	setList(java.util.List list) Changes the list that defines this sequence and resets the index of the models 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. param list the sequence that this model represents throws IllegalArgumentException if list is null or zero length see #getList if ((list == null) || (list.size() == 0)) { throw new IllegalArgumentException("invalid list"); } if (!list.equals(this.list)) { this.list = list; index = 0; fireStateChanged(); }
public void	setValue(java.lang.Object elt) Changes the current element of the sequence and notifies 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"); param elt the sequence element that will be model's current value throws IllegalArgumentException if the specified value isn't allowed see SpinnerModel#setValue see #getValue int index = list.indexOf(elt); if (index == -1) { throw new IllegalArgumentException("invalid sequence element"); } else if (index != this.index) { this.index = index; fireStateChanged(); }