QSpinBox、QDoubleSpinBox

QSpinBox 

一、描述

QSpinBox 继承自 QAbstractSpinBox 旨在处理整数和离散值。

子类化 QSpinBox

如果使用 prefix()、suffix() 和 specialValueText() 不能提供足够的控制，则将 QSpinBox 子类化并重新实现 valueFromText() 和 textFromValue()。 例如，这是一个自定义旋转框的代码，它允许用户输入图标大小（例如，“32 x 32”）：

二、属性成员

1、【只读】cleanText : const QString

微调框的文本，不包括任何前缀、后缀或前导或尾随空格。

2、displayIntegerBase : int

用于显示微调框值的基数（进制数）。默认为 10。范围是2~36。

3、maximum : int

最大值。默认为 99。设置此属性时，如有必要，会调整最小值，以确保范围保持有效。

     minimum : int

最小值，默认为 0。设置此属性时，如有必要，会调整最大值以确保范围保持有效。

 4、prefix : QString

前缀。前缀被添加到显示值的开头。典型用途是显示计量单位或货币符号。例如：

sb->setPrefix("￥");

      suffix : QString

后缀。后缀附加到显示值的末尾。典型用途是显示计量单位或货币符号。 例如：

sb->setSuffix(" km");

5、singleStep : int

步长值。默认为 1。

当用户按下箭头按钮更改值时，该值将按步长值递增/递减。

将 singleStep 值设置为小于 0 不会执行任何操作。

6、stepType : StepType

步长变化类型。

• DefaultStepType：单步。
• AdaptiveDecimalStepType：自适应小数步。

7、value : int

当前值。

三、成员函数

1、【信号】void textChanged(const QString &text)

每当文本发生更改时，都会发出此信号。text 带前缀、后缀。

2、【信号】void valueChanged(int i)

每当值发生更改时，都会发出此信号。i 为新值。

3、void setRange(int minimum, int maximum)

设置最小值和最大值。 

4、void setStepType(QAbstractSpinBox::StepType stepType)

设置步长类型。

自适应小数步（AdaptiveDecimalStepType）：步长将连续调整到当前值以下的 10 次方。例如：当值为 1100 时，步长设置为 100，因此增加一次会将其增加到 1200；对于 1200，增加会将其增加到 1300；对于负值，从 -1100 减少到 -1200。

在处理边缘情况时会考虑步进方向，例如从 100 递减会将值变为 99 而不是 90。

设置此项将导致微调框忽略 singleStep 的值。

5、【虚函数】QString textFromValue(int value)

每当需要显示给定值时，微调框都会调用此函数。 默认实现返回一个字符串，其中包含使用 QWidget::locale().toString() 以标准方式打印的值。

子类化时可重新实现自定义内容。

注意：QSpinBox 不会为 specialValueText() 调用此函数，并且返回值中不应包含 prefix() 和 suffix()。

如果重新实现它，可能还需要重新实现 valueFromText() 和 validate()

6、【虚函数】int valueFromText(const QString &text)

当微调框需要将用户输入的文本解释为值时，它就会调用这个函数。

需要以非数字方式显示微调框值的子类需要重新实现该函数。

---

QDoubleSpinBox

 一、描述

QDoubleSpinBox 继承自 QAbstractSpinBox  ，是支持双精度的微调框。

QDoubleSpinBox 将对数字进行四舍五入，以便以当前精度显示它们。如在小数点设置为 2 的 QDoubleSpinBox 中，调用 setValue(2.555) 将导致 value() 返回 2.56。

QDoubleSpinBox 的显示值除了最终的前缀和后缀内容外，限制为 18 个字符。

二、属性成员

1、decimals : int

精度，以小数为单位。

最大值、最小值和当前值可能会因更改此属性而发生变化。

2、value : double

微调框的值。该值将被四舍五入，以便以当前设置的小数显示。

其他属性见：QSpinBox。

三、成员函数

API和QSpinBox一致。