javax.swing
介面 SpinnerModel

所有已知實作類別：

AbstractSpinnerModel, SpinnerDateModel, SpinnerListModel, SpinnerNumberModel

public interface SpinnerModel

物件值的潛在無界序列的模型。此模型類似於 ListModel，但是有以下一些重要區別：

• 序列元素數不一定是有界的。
• 該模型不支持對序列元素的索引隨機存取。一次只有以下三個序列值可以存取：當前值、下一個值和前一個值。
• 可以設置當前序列元素。

SpinnerModel 有三個屬性，只有第一個是讀/寫屬性。

value

該序列的當前元素。

nextValue

下一個元素，如果 value 是該序列的最後一個元素，則為 null。

previousValue

前一個元素，如果 value 是該序列的第一個元素，則為 null。

當 value 屬性更改時，將通知 ChangeListeners。在其他情況下，SpinnerModel 可以選擇通知 ChangeListeners。

從以下版本開始：

1.4

另請參見：

JSpinner, AbstractSpinnerModel, SpinnerListModel, SpinnerNumberModel, SpinnerDateModel

方法摘要

void	addChangeListener(ChangeListener l) 向該模型的偵聽器列表添加一個 ChangeListener。
Object	getNextValue() 返回該序列中出現在 getValue() 返回的物件之後的物件。
Object	getPreviousValue() 返回該序列中出現在 getValue() 返回的物件之前的物件。
Object	getValue() 該序列的當前元素。
void	removeChangeListener(ChangeListener l) 從該模型的偵聽器列表移除一個 ChangeListener。
void	setValue(Object value) 改變該模型的當前值，通常此值由 JSpinner 的 editor 部分顯示。

方法詳細資訊

getValue

Object getValue()

該序列的當前元素。此元素通常由 JSpinner 的 editor 部分顯示。

返回：

當前的 spinner 值。

另請參見：

setValue(java.lang.Object)

setValue

void setValue(Object value)

改變該模型的當前值，通常此值由 JSpinner 的 editor 部分顯示。如果 SpinnerModel 實作不支持指定值，則拋出一個 IllegalArgumentException。例如，數字的 SpinnerModel 可能只支持 10 的整數倍的值。在這種情況下，model.setValue(new Number(11)) 將拋出一個異常。

拋出：

IllegalArgumentException - 如果不允許 value

另請參見：

getValue()

getNextValue

Object getNextValue()

返回該序列中出現在 getValue() 返回的物件之後的物件。如果已到達該序列的結尾，則返回 null。調用此方法不會影響 value。

返回：

下一個合法值，如果一個也不存在，則返回 null

另請參見：

getValue(), getPreviousValue()

getPreviousValue

Object getPreviousValue()

返回該序列中出現在 getValue() 返回的物件之前的物件。如果已到達該序列的結尾，則返回 null。調用此方法不會影響 value。

返回：

前一個合法值，如果一個也不存在，則返回 null

另請參見：

getValue(), getNextValue()

addChangeListener

void addChangeListener(ChangeListener l)

向該模型的偵聽器列表添加一個 ChangeListener。模型 value 變化時，必須通知該 ChangeListeners。

參數：

l - 要添加的 ChangeListener

另請參見：

removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

void removeChangeListener(ChangeListener l)

從該模型的偵聽器列表移除一個 ChangeListener。

參數：

l - 要移除的 ChangeListener

另請參見：

addChangeListener(javax.swing.event.ChangeListener)