模块  java.desktop
软件包  javax.swing

Class SpinnerNumberModel

  • 实现的所有接口
    SerializableSpinnerModel

    public class SpinnerNumberModel
    extends AbstractSpinnerModel
    implements Serializable
    SpinnerModel用于数字序列。 序列的上限和下限由名为minimummaximum属性定义。 nextValuepreviousValue方法计算的增加或减少的大小由名为stepSize的属性定义。 minimummaximum属性可以是null以指示序列没有下限或上限。 此类中的所有属性都是根据两种泛型类型定义的: NumberComparable ,因此可以容纳所有Java数字类型。 在内部,有只为值类型为原始的一个支持Number类型: DoubleFloatLongIntegerShort ,或Byte

    要为整数范围0到100创建SpinnerNumberModel ,以50作为初始值,可以写:

      Integer value = Integer.valueOf(50);
     Integer min = Integer.valueOf(0);
     Integer max = Integer.valueOf(100);
     Integer step = Integer.valueOf(1);
     SpinnerNumberModel model = new SpinnerNumberModel(value, min, max, step);
     int fifty = model.getNumber().intValue(); 

    整数和双精度的旋转器很常见,因此提供了这些情况的特殊构造器。 例如,要在上一个示例中创建模型,还可以编写:

      SpinnerNumberModel model = new SpinnerNumberModel(50, 0, 100, 1); 

    此模型继承ChangeListener ChangeListeners通知每当模型valuestepSizeminimum ,或maximum性质的变化。

    从以下版本开始:
    1.4
    另请参见:
    JSpinnerSpinnerModelAbstractSpinnerModelSpinnerListModelSpinnerDateModelSerialized Form
    • 构造方法详细信息

      • SpinnerNumberModel

        public SpinnerNumberModel​(Number value,
                                  Comparable<?> minimum,
                                  Comparable<?> maximum,
                                  Number stepSize)
        构造一个SpinnerModel ,表示从minimummaximum的闭合数字序列。 nextValuepreviousValue方法分别通过添加或减去stepSize来计算序列的元素。 所有参数必须是相互ComparablevaluestepSize必须的情况下Integer LongFloat ,或Double

        minimummaximum参数可以是null ,表示该范围没有上限或下限。 如果valuestepSizenull ,或者如果指定了minimummaximum并且minimum > maximum则抛出IllegalArgumentException 同样,如果(minimum <= value <= maximum )为假,则抛出IllegalArgumentException

        参数
        value - 模型的当前(非 null )值
        minimum - 序列中的第一个数字或 null
        maximum - 序列中的最后一个数字或 null
        stepSize - 序列元素之间的差异
        异常
        IllegalArgumentException - 如果stepSize或value为 null或者如果以下表达式为false: minimum <= value <= maximum
      • SpinnerNumberModel

        public SpinnerNumberModel​(int value,
                                  int minimum,
                                  int maximum,
                                  int stepSize)
        构造一个 SpinnerNumberModel带有指定 valueminimum / maximum界限, stepSize
        参数
        value - 模型的当前值
        minimum - 序列中的第一个数字
        maximum - 序列中的最后一个数字
        stepSize - 序列元素之间的差异
        异常
        IllegalArgumentException - 如果以下表达式为false: minimum <= value <= maximum
      • SpinnerNumberModel

        public SpinnerNumberModel​(double value,
                                  double minimum,
                                  double maximum,
                                  double stepSize)
        构造一个 SpinnerNumberModel带有指定 valueminimum / maximum界限, stepSize
        参数
        value - 模型的当前值
        minimum - 序列中的第一个数字
        maximum - 序列中的最后一个数字
        stepSize - 序列元素之间的差异
        异常
        IllegalArgumentException - 如果以下表达式为false: minimum <= value <= maximum
      • SpinnerNumberModel

        public SpinnerNumberModel()
        构造 SpinnerNumberModel其中没有 minimummaximum值, stepSize等于1,初始值为零。
    • 方法详细信息

      • setMinimum

        public void setMinimum​(Comparable<?> minimum)
        更改此序列中数字的下限。 如果minimumnull ,那么没有下限。 这里没有边界检查; 新的minimum值可能会使构造函数强制执行的(minimum <= value <= maximum)不变量无效。 这是为了简化更新该模式,自然应该确保该等式是调用之前真正getNextValuegetPreviousValue ,或setValue方法。

        典型地,这个属性是一个Number的相同类型的value然而有可能使用任何Comparable带有compareTo方法用于Number用相同类型作为值。 例如,如果value是Long ,则minimum可能是如下定义的Date子类:

          MyDate extends Date {  // Date already implements Comparable
             public int compareTo(Long o) {
                 long t = getTime();
                 return (t < o.longValue() ? -1 : (t == o.longValue() ? 0 : 1));
             }
         } 

        如果minimum已更改,则此方法将触发ChangeEvent

        参数
        minimum - Comparable ,其 compareTo方法为 Number s,类型与 value
        另请参见:
        getMinimum()setMaximum(java.lang.Comparable<?>)SpinnerModel.addChangeListener(javax.swing.event.ChangeListener)
      • setMaximum

        public void setMaximum​(Comparable<?> maximum)
        更改此序列中数字的上限。 如果maximumnull ,那么没有上限。 这里没有边界检查; 新的maximum值可能会使构造函数强制执行的(minimum <= value < maximum)不变量无效。 这是为了简化更新该模式,自然应该确保该等式是调用之前真正nextprevious ,或setValue方法。

        通常,此属性是与Number相同类型的value但是可以使用任何ComparablecompareTo方法用于Number ,其类型与值相同。 有关示例 ,请参见setMinimum(Comparable)

        如果maximum已更改,则此方法将触发ChangeEvent

        参数
        maximum - Comparable ,其 compareTo方法,适用于 Number s,类型与 value
        另请参见:
        getMaximum()setMinimum(java.lang.Comparable<?>)SpinnerModel.addChangeListener(javax.swing.event.ChangeListener)
      • getStepSize

        public Number getStepSize()
        返回 getNextValuegetPreviousValue方法计算的值更改的大小。
        结果
        stepSize属性的值
        另请参见:
        setStepSize(java.lang.Number)
      • setValue

        public void setValue​(Object value)
        设置此序列的当前值。 如果valuenull ,或者不是Number ,则抛出IllegalArgumentException 这里没有边界检查; 新值可能会使构造函数强制执行的(minimum <= value <= maximum)不变量无效。 也可以将值设置为序列中不会自然出现的值,即不是stepSize的模stepSize 这是为了简化模型的更新,并适应不想限制用户直接输入的值的微调器。 当然,应该确保(minimum <= value <= maximum)不变的是调用之前真正nextprevious ,或setValue方法。

        如果值已更改,则此方法将触发ChangeEvent

        Specified by:
        setValue接口 SpinnerModel
        参数
        value - 此序列的当前(非 nullNumber
        异常
        IllegalArgumentException - 如果 valuenull或者不是 Number
        另请参见:
        getNumber()getValue()SpinnerModel.addChangeListener(javax.swing.event.ChangeListener)