javax.swing

クラスSpinnerListModel

java.lang.Object

javax.swing.AbstractSpinnerModel

javax.swing.SpinnerListModel

すべての実装されたインタフェース:

Serializable, SpinnerModel

public class SpinnerListModel
extends AbstractSpinnerModel
implements Serializable

配列またはListによって値を定義するSpinnerModelの単純な実装です。たとえば、曜日の配列で定義するモデルを作成するには、次のように記述します。

 String[] days = new DateFormatSymbols().getWeekdays();
 SpinnerModel model = new SpinnerListModel(Arrays.asList(days).subList(1, 8));
 

このクラスは、配列またはListへの参照を格納するだけです。そのため、基本となるシーケンスの要素が変更された場合は、アプリケーション側でfireStateChangedを呼び出してChangeListenersに変更を通知します。

このモデルはChangeListenerを継承します。モデルのvalueプロパティまたはlistプロパティが変更されたときには、ChangeListenerに変更が通知されます。

導入されたバージョン:

1.4

関連項目:

JSpinner, SpinnerModel, AbstractSpinnerModel, SpinnerNumberModel, SpinnerDateModel

フィールドのサマリー

クラス javax.swing.AbstractSpinnerModelから継承されたフィールド

listenerList

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
SpinnerListModel() 事実上空のSpinnerListModelを構築します。
SpinnerListModel(List<?> values) 指定されたListで値のシーケンスを定義するSpinnerModelを構築します。
SpinnerListModel(Object[] values) 指定された配列で値のシーケンスを定義するSpinnerModelを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
List<?>	getList() このモデルのシーケンスを定義するListを返します。
Object	getNextValue() 基本となるシーケンスの次の正当な値を返します。値がすでに最後の要素の場合はnullを返します。
Object	getPreviousValue() 基本となるシーケンスの前の要素を返します。値がすでに最初の要素の場合はnullを返します。
Object	getValue() シーケンスの現在の要素を返します。
void	setList(List<?> list) このシーケンスを定義するリストを変更し、モデルのvalueのインデックスを0にリセットします。
void	setValue(Object elt) シーケンスの現在の要素を変更し、ChangeListenersに通知します。

クラス javax.swing.AbstractSpinnerModelから継承されたメソッド

addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

SpinnerListModel

public SpinnerListModel(List<?> values)

指定されたListで値のシーケンスを定義するSpinnerModelを構築します。モデルの初期値(現在の要素)はvalues.get(0)です。valuesがnull、あるいはサイズが0の場合、IllegalArugmentExceptionがスローされます。

パラメータ:

values - このモデルが表すシーケンス

例外:

IllegalArgumentException - valuesがnullまたはサイズが0の場合

SpinnerListModel

public SpinnerListModel(Object[] values)

指定された配列で値のシーケンスを定義するSpinnerModelを構築します。モデルの初期値はvalues[0]です。valuesがnull、あるいは長さが0の場合、IllegalArgumentExceptionがスローされます。

パラメータ:

values - このモデルが表すシーケンス

例外:

IllegalArgumentException - valuesがnullまたは長さが0の場合。

SpinnerListModel

public SpinnerListModel()

事実上空のSpinnerListModelを構築します。モデルのリストには、1つの「空」の文字列要素が含まれます。

メソッドの詳細

getList

public List<?> getList()

このモデルのシーケンスを定義するListを返します。

戻り値:

listプロパティの値

関連項目:

setList(java.util.List<?>)

setList

public void setList(List<?> list)

このシーケンスを定義するリストを変更し、モデルのvalueのインデックスを0にリセットします。listはコピーされません。モデルはそれへの参照を格納するだけです。

listが現在のリストと異なる場合、このメソッドはChangeEventをトリガーします。

パラメータ:

list - このモデルが表すシーケンス

例外:

IllegalArgumentException - listがnullまたは長さが0の場合。

関連項目:

getList()

getValue

public Object getValue()

シーケンスの現在の要素を返します。

定義:

getValue、インタフェース: SpinnerModel

戻り値:

valueプロパティ

関連項目:

SpinnerModel.getValue(), setValue(java.lang.Object)

setValue

public void setValue(Object elt)

シーケンスの現在の要素を変更し、ChangeListenersに通知します。指定された値が基本となるシーケンスの要素と異なる場合、IllegalArgumentExceptionがスローされます。次の例では、setValue呼出しによって、例外がスローされます。

 String[] values = {"one", "two", "free", "four"};
 SpinnerModel model = new SpinnerListModel(values);
 model.setValue("TWO");
 

定義:

setValue、インタフェース: SpinnerModel

パラメータ:

elt - モデルの現在の値となるシーケンスの要素

例外:

IllegalArgumentException - 指定された値が正当でない場合

関連項目:

SpinnerModel.setValue(java.lang.Object), getValue()

getNextValue

public Object getNextValue()

基本となるシーケンスの次の正当な値を返します。値がすでに最後の要素の場合はnullを返します。

定義:

getNextValue、インタフェース: SpinnerModel

戻り値:

配下のシーケンスの次の正当な値、または値がすでに最後の要素である場合はnull

関連項目:

SpinnerModel.getNextValue(), getPreviousValue()

getPreviousValue

public Object getPreviousValue()

基本となるシーケンスの前の要素を返します。値がすでに最初の要素の場合はnullを返します。

定義:

getPreviousValue、インタフェース: SpinnerModel

戻り値:

配下のシーケンスの前の要素、または値がすでに先頭の要素である場合はnull

関連項目:

SpinnerModel.getPreviousValue(), getNextValue()