モジュール 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

  • コンストラクタの詳細

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