javax.swing
類別 SpinnerListModel

java.lang.Object
  javax.swing.AbstractSpinnerModel
      javax.swing.SpinnerListModel

所有已實作的介面：

Serializable, SpinnerModel

public class SpinnerListModel
extends AbstractSpinnerModel
implements Serializable

其值由陣列或 List 定義的 SpinnerModel 的簡單實作。例如，創建一個由一周幾天的名稱陣列定義的模型：

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

此類別只存儲對該陣列或 List 的參考，所以，如果基礎序列的元素發生變化，則應用程序有責任通過調用 fireStateChanged 通知 ChangeListeners。

此模型繼承的是一個 ChangeListener。每當該模型的 value 或 list 屬性發生變化時，就會通知 ChangeListener。

從以下版本開始：

1.4

另請參見：

JSpinner, SpinnerModel, AbstractSpinnerModel, SpinnerNumberModel, SpinnerDateModel

欄位摘要

從類別 javax.swing.AbstractSpinnerModel 繼承的欄位

listenerList

建構子摘要

SpinnerListModel()
創建一個實際為空的 SpinnerListModel。

SpinnerListModel(List<?> values)
建構一個由指定 List 定義其值序列的 SpinnerModel。

SpinnerListModel(Object[] values)
建構一個由指定陣列定義其值序列的 SpinnerModel。

方法摘要

List<?>	getList() 返回定義此模型的序列的 List。
Object	getNextValue() 返回基礎序列的下一個合法值，如果值已經是最後一個元素，則返回 null。
Object	getPreviousValue() 返回該基礎序列的前一個元素，如果值已經是第一個元素，則返回 null。
Object	getValue() 返回該序列的當前元素。
void	setList(List<?> list) 更改定義此序列的列表，並將該模型 value 的索引重新設置為零。
void	setValue(Object elt) 改變該序列的當前元素並通知 ChangeListeners。

從類別 javax.swing.AbstractSpinnerModel 繼承的方法

addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

SpinnerListModel

public SpinnerListModel(List<?> values)

建構一個由指定 List 定義其值序列的 SpinnerModel。該模型的初始值（當前元素）將為 values.get(0)。如果 values 為 null 或具有零大小，則拋出一個 IllegalArugmentException。

參數：

values - 此模型表示的序列

拋出：

IllegalArugmentException - 如果 values 為 null 或零大小

SpinnerListModel

public SpinnerListModel(Object[] values)

建構一個由指定陣列定義其值序列的 SpinnerModel。該模型的初始值將為 values[0]。如果 values 為 null 或具有零長度，則拋出一個 IllegalArugmentException。

參數：

values - 此模型表示的序列

拋出：

IllegalArugmentException - 如果 values 為 null 或零長度

SpinnerListModel

public SpinnerListModel()

創建一個實際為空的 SpinnerListModel。該模型的列表將包含單個的 "empty" 字元串元素。

方法詳細資訊

getList

public List<?> getList()

返回定義此模型的序列的 List。

返回：

該 list 屬性的值

另請參見：

setList(java.util.List)

setList

public void setList(List<?> list)

更改定義此序列的列表，並將該模型 value 的索引重新設置為零。注意，不複製 list，該模型只存儲對它的參考。

如果 list 不等於當前列表，則此方法觸發一個 ChangeEvent。

參數：

list - 此模型表示的序列

拋出：

IllegalArgumentException - 如果 list 為 null 或零長度

另請參見：

getList()

getValue

public Object getValue()

返回該序列的當前元素。

指定者：

介面 SpinnerModel 中的 getValue

返回：

該 value 屬性

另請參見：

SpinnerModel.getValue(), setValue(java.lang.Object)

setValue

public void setValue(Object elt)

改變該序列的當前元素並通知 ChangeListeners。如果指定值不等於基礎序列的元素，則拋出一個 IllegalArgumentException。在以下範例中，該 setValue 調用會拋出一個異常：

 String[] values = {"one", "two", "free", "four"};
 SpinnerModel model = new SpinnerListModel(values);
 model.setValue("TWO");
 

指定者：

介面 SpinnerModel 中的 setValue

參數：

elt - 將作為模型當前值的序列元素

拋出：

IllegalArgumentException - 如果不允許指定值

另請參見：

SpinnerModel.setValue(java.lang.Object), getValue()

getNextValue

public Object getNextValue()

返回基礎序列的下一個合法值，如果值已經是最後一個元素，則返回 null。

指定者：

介面 SpinnerModel 中的 getNextValue

返回：

該基礎序列的下一個合法值，或返回 null 如果值已經是最後一個元素

另請參見：

SpinnerModel.getNextValue(), getPreviousValue()

getPreviousValue

public Object getPreviousValue()

返回該基礎序列的前一個元素，如果值已經是第一個元素，則返回 null。

指定者：

介面 SpinnerModel 中的 getPreviousValue

返回：

該基礎序列的前一個元素，如果值已經是第一個元素，則返回 null

另請參見：

SpinnerModel.getPreviousValue(), getNextValue()