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) モデルの現在の値を変更します。

メソッドの詳細

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)