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)