QDoubleSpinBox 类

成员函数文档

[显式] QDoubleSpinBox::QDoubleSpinBox(QWidget *parent = nullptr)

构建一个具有最小值0.0和最大值99.99的微调框，步值1.0和精度2位十进制的微调框。初始值设置为0.00。微调框具有给定的父元素。

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

[虚拟 noexcept] QDoubleSpinBox::~QDoubleSpinBox()

析构器。

[覆盖虚拟] void QDoubleSpinBox::fixup(QString &input) const

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

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

单次函数调用即可设置 最小 和 最大 值的便利函数。

注意：最大值和最小值将被四舍五入以匹配小数属性。

setRange(minimum, maximum);

等价于

setMinimum(minimum);
setMaximum(maximum);

另见minimum 和 maximum.

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

为滚动框设置步进类型为 stepType，即单步或自适应小数步进。

自适应小数步进意味着步进大小将不断调整到当前 值 以下的十的幂。因此，当值为 1100 时，步进设置为 100，因此上一步增加使其变为 1200。对于 1200 ，上一步将其增加到 1300。对于负值，从 -1100 减少到 -1200。

这也适用于任何小数值，0.041 通过一次步进增加到 0.042。

考虑步进方向以处理边缘情况，因此从 100 减少到 99 而不是 90。因此，上一步后跟下一步或反之亦然始终落在起始值；99 -> 100 -> 99。

设置此选项将导致滚动框忽略 singleStep 的值，尽管它被保留下来，以便在以后关闭自适应小数步进时 singleStep 生效。

另见stepType().

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

每当滚动框的文本发生变化时，都会发出此信号。新的文本在 text 中传递，附带 prefix() 和 suffix().

[虚拟] QString QDoubleSpinBox::textFromValue(double value) const

此虚拟函数由滚动框用来显示给定的 值。默认实现返回一个包含 value 的字符串，使用 QWidget::locale().toString(value, u'f', decimals()) 并在未设置 setGroupSeparatorShown() 时删除千位分隔符。重写可以实现任何内容。

注意：QDoubleSpinBox 对于 specialValueText() 不调用此函数，且不应在返回值中包含 prefix() 或 suffix().

如果您重写此函数，您可能还需要重写 valueFromText().

另见valueFromText() 和 QLocale::groupSeparator().

[重载虚拟] QValidator::State QDoubleSpinBox::validate(QString &text, int &pos) const

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

[信号] void QDoubleSpinBox::valueChanged(double d)

每当微调框的值改变时，都会发射此信号。新值通过d传递。

[虚函数] double QDoubleSpinBox::valueFromText(const QString &text) const

此虚函数由微调框在需要将用户输入的文本作为值进行解释时使用。

需要以非数字方式显示微调框值的子类需要重写此函数。

注意：QDoubleSpinBox单独处理specialValueText()，此函数只涉及其他值。

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