モジュール java.desktop
パッケージ 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)
      モデルの現在の値を変更します。通常、この値はJSpinnerのeditor部分によって表示されます。

    • メソッドの詳細

      • 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))では例外がスローされます。
        パラメータ:
        value - スピナーの新しい価値
        例外:
        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)