javax.swing

インタフェース SpinnerModel

既知のすべての実装クラス:

AbstractSpinnerModel, SpinnerDateModel, SpinnerListModel, SpinnerNumberModel

public interface SpinnerModel

要素を無限に作成できるオブジェクト値シーケンスを表すモデルです。このモデルは ListModel に似ていますが、次に示す重要な相違点があります。

• シーケンスの要素数が必ずしも有限個でない。
• シーケンスの要素に対するインデックスによるランダムアクセスをサポートしていない。現在、次、前という 3 つのシーケンス値にのみ同時にアクセスできる。
• 現在のシーケンス要素を設定できる。

SpinnerModel には 3 つのプロパティーがあります。最初のプロパティーのみ、読み込みと書き込みが可能です。

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 部分に表示されます。

戻り値:

スピナーの現在の値。

関連項目:

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)