QDoubleSpinBox Class

成员函数文档

[explicit] QDoubleSpinBox::QDoubleSpinBox(QWidget *parent = nullptr)

创建一个旋转输入框，其最小值为 0.0，最大值为 99.99，步长为 1.0，精度为小数点后 2 位。初始值设为 0.00。该旋转输入框具有给定的parent 。

另请参阅 setMinimum()、setMaximum() 和setSingleStep()。

[virtual noexcept] QDoubleSpinBox::~QDoubleSpinBox()

析构函数。

[override virtual] void QDoubleSpinBox::fixup(QString &input) const

重新实现了：QAbstractSpinBox::fixup(QString &input) const。

void QDoubleSpinBox::setRange(double minimum, double maximum)

一种便捷函数，可通过单次函数调用设置minimum 和maximum 的值。

注意：最大值和最小值将被四舍五入，以符合小数点位数属性。

setRange(minimum, maximum);

等同于：

setMinimum(minimum);
setMaximum(maximum);

另请参阅 minimum 和maximum 。

void QDoubleSpinBox::setStepType(QAbstractSpinBox::StepType stepType)

将旋转框的步长类型设置为stepType ，即单步或自适应十进制步长。

自适应十进制步长意味着步长将持续调整为比当前value 低一个十的幂。因此，当值为1100时，步长设置为100，向上调整一次即增加到1200；当值为1200时，向上调整一次则变为1300。 对于负值，从-1100向下步进一次将变为-1200。

该机制也适用于任何小数值，例如 0.041 经过一次步进后会增加到 0.042。

系统会考虑步长方向以处理边界情况，因此从 100 向下步进时，值会变为 99 而不是 90。因此，先向上步进再向下步进——或反之——最终总会回到起始值；例如 99 -> 100 -> 99。

设置此选项将导致旋转框忽略singleStep 的值，尽管该值会被保留，以便在后续关闭自适应小数步长时，singleStep 能生效。

另请参阅 stepType()。

[signal] void QDoubleSpinBox::textChanged(const QString &text)

每当旋转框中的文本发生变化时，都会触发此信号。新文本将通过 `prefix()` 和 `suffix()` 传递给 `text `。

[virtual] QString QDoubleSpinBox::textFromValue(double value) const

每当旋转框需要显示给定的value 时，都会调用此虚拟函数。默认实现会返回一个字符串，其中包含使用QWidget::locale()打印的value 。该字符串通过toString()（value 、u'f' 、decimals()）生成，并会去除千位分隔符，除非设置了setGroupSeparatorShown()。重写该函数时，可返回任意内容。

注意：QDoubleSpinBox 不会在调用specialValueText() 时调用此函数，且prefix() 和suffix() 均不应包含在返回值中。

若重写此函数，可能还需要重写valueFromText()。

另请参见 valueFromText() 和QLocale::groupSeparator()。

[override virtual] QValidator::State QDoubleSpinBox::validate(QString &text, int &pos) const

重写了：QAbstractSpinBox::validate(QString &input, int &pos) const。

[signal] void QDoubleSpinBox::valueChanged(double d)

每当旋转选择框的值发生变化时，都会触发此信号。新值将通过d 传递进来。

[virtual] double QDoubleSpinBox::valueFromText(const QString &text) const

每当旋转框需要将用户输入的text 解释为一个值时，都会调用此虚拟函数。

需要以非数值形式显示旋转框值的子类，必须重写此函数。

注意：QDoubleSpinBox 会单独处理specialValueText()；此函数仅处理其他值。

另请参阅 textFromValue() 和validate()。