モジュール java.desktop

パッケージ 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(Object[] values)	指定された配列で値のシーケンスを定義するSpinnerModelを構築します。
SpinnerListModel(List<?> values)	指定されたListで値のシーケンスを定義する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であるか、サイズがゼロの場合は、IllegalArgumentExceptionがスローされます。

パラメータ:

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()