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()。