- 既知のすべての実装クラス:
AbstractSpinnerModel
,SpinnerDateModel
,SpinnerListModel
,SpinnerNumberModel
public interface SpinnerModel
要素を無限に作成できるオブジェクト値シーケンスを表すモデルです。 このモデルは
ListModel
に似ていますが、次に示す重要な相違点があります。
- シーケンスの要素数が必ずしも有限個でない。
- シーケンスの要素に対するインデックスによるランダム・アクセスをサポートしていない。 現在、次、前という3つのシーケンス値にのみ同時にアクセスできる。
- 現在のシーケンス要素を設定できる。
SpinnerModel
には3つのプロパティがあります。最初のプロパティのみ、読み込みと書込みが可能です。
value
- シーケンスの現在の要素。
nextValue
- 次の要素。
value
がシーケンスの最後の要素の場合はnull。 previousValue
- 前の要素。
value
がシーケンスの最初の要素の場合はnull。
value
プロパティが変更されると、ChangeListeners
に通知されます。 SpinnerModel
は、それ以外の状況でもChangeListeners
に通知を送る設定にできます。 - 導入されたバージョン:
- 1.4
- 関連項目:
-
メソッドのサマリー
修飾子と型メソッド説明void
モデルのリスナー・リストにChangeListener
を追加します。getValue()
によって返されたオブジェクトの後にあるシーケンスのオブジェクトを返します。getValue()
によって返されたオブジェクトの前にあるシーケンスのオブジェクトを返します。getValue()
シーケンスの現在の要素。void
ChangeListener
をモデルのリスナー・リストから削除します。void
モデルの現在の値を変更します。通常、この値はJSpinner
のeditor
部分によって表示されます。
-
メソッドの詳細
-
getValue
Object getValue()シーケンスの現在の要素。 この要素は通常、JSpinner
のeditor
部分に表示されます。- 戻り値:
- スピナーの現在の値。
- 関連項目:
-
setValue
void setValue(Object value) モデルの現在の値を変更します。通常、この値はJSpinner
のeditor
部分によって表示されます。SpinnerModel
の実装が指定された値をサポートしていない場合は、IllegalArgumentException
がスローされます。 たとえば、数値のSpinnerModel
が10の倍数の整数しかサポートしていないと仮定します。 その場合、model.setValue(new Number(11))
では例外がスローされます。- パラメータ:
value
- スピナーの新しい価値- 例外:
IllegalArgumentException
-value
が正当でない場合- 関連項目:
-
getNextValue
Object getNextValue()getValue()
によって返されたオブジェクトの後にあるシーケンスのオブジェクトを返します。 シーケンスの終点に到達した場合、nullを返します。 このメソッドを呼び出しても、value
には影響しません。- 戻り値:
- 次の正当な値、またはそれが存在しない場合はnull
- 関連項目:
-
getPreviousValue
Object getPreviousValue()getValue()
によって返されたオブジェクトの前にあるシーケンスのオブジェクトを返します。 シーケンスの終点に到達した場合、nullを返します。 このメソッドを呼び出しても、value
には影響しません。- 戻り値:
- 直前の正当な値、またはそれが存在しない場合はnull
- 関連項目:
-
addChangeListener
void addChangeListener(ChangeListener l) モデルのリスナー・リストにChangeListener
を追加します。 モデルのvalue
を変更した場合、ChangeListeners
に変更を通知する必要があります。- パラメータ:
l
- 追加するChangeListener- 関連項目:
-
removeChangeListener
void removeChangeListener(ChangeListener l) ChangeListener
をモデルのリスナー・リストから削除します。- パラメータ:
l
- 削除するChangeListener- 関連項目:
-