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)