模块  java.desktop
软件包  javax.swing

Class SpinnerNumberModel

  • 实现的所有接口
    Serializable ， SpinnerModel 
    public class SpinnerNumberModel
extends AbstractSpinnerModel
implements Serializable
    SpinnerModel用于数字序列。 序列的上限和下限由名为minimum和maximum属性定义。 由nextValue和previousValue方法计算的增加或减少的大小由名为stepSize的属性定义。 minimum和maximum属性可以是null以指示序列没有下限或上限。 此类中的所有属性都是根据两种泛型类型定义的： Number和Comparable ，因此可以容纳所有Java数字类型。 在内部，有只为值类型为原始的一个支持Number类型： Double ， Float ， Long ， Integer ， Short ，或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通知每当模型value ， stepSize ， minimum ，或maximum性质的变化。

    从以下版本开始：
    1.4
    另请参见：
    JSpinner ， SpinnerModel ， AbstractSpinnerModel ， SpinnerListModel ， SpinnerDateModel ， Serialized Form

    • 构造方法详细信息

      • SpinnerNumberModel

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

        minimum和maximum参数可以是null ，表示该范围没有上限或下限。 如果value或stepSize是null ，或者如果指定了minimum和maximum并且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带有指定 value ， minimum / maximum界限， stepSize 。
        参数
        value - 模型的当前值
        minimum - 序列中的第一个数字
        maximum - 序列中的最后一个数字
        stepSize - 序列元素之间的差异
        异常
        IllegalArgumentException - 如果以下表达式为false： minimum <= value <= maximum

      • SpinnerNumberModel

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

      • SpinnerNumberModel

        public SpinnerNumberModel()
        构造 SpinnerNumberModel其中没有 minimum或 maximum值， stepSize等于1，初始值为零。

    • 方法详细信息

      • setMinimum

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

        通常，此属性是与Number相同类型的value但是可以使用任何Comparable和compareTo方法用于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()
        返回 getNextValue和 getPreviousValue方法计算的值更改的大小。
        结果
        stepSize属性的值
        另请参见：
        setStepSize(java.lang.Number)

      • setValue

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

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

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