QDoubleSpinBox Class

Documentación de las funciones miembro

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

Construye una caja giratoria con 0,0 como valor mínimo y 99,99 como valor máximo, un valor de paso de 1,0 y una precisión de 2 decimales. El valor inicial es 0.00. El cuadro de giro tiene el valor parent.

Véase también setMinimum(), setMaximum() y setSingleStep().

[virtual noexcept] QDoubleSpinBox::~QDoubleSpinBox()

Destructor.

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

Reimplementa: QAbstractSpinBox::fixup(QString &input) const.

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

Función de conveniencia para establecer los valores minimum y maximum con una sola llamada a la función.

Nota: Los valores máximo y mínimo se redondearán para que coincidan con la propiedad decimales.

setRange(minimum, maximum);

es equivalente a:

setMinimum(minimum);
setMaximum(maximum);

Véase también minimum y maximum.

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

Establece el tipo de paso para la caja de giro en stepType, que es paso único o paso decimal adaptativo.

Paso decimal adaptativo significa que el tamaño del paso se ajustará continuamente a una potencia de diez por debajo del valor actual value. Así, cuando el valor es 1100, el paso se establece en 100, por lo que subir una vez lo aumenta a 1200. Si el valor es 1200, al subir el escalón llega a 1300. Para valores negativos, al bajar de -1100 se llega a -1200.

También funciona para cualquier valor decimal, 0.041 se incrementa a 0.042 dando un paso.

La dirección del paso se tiene en cuenta para manejar los casos extremos, de modo que bajar desde 100 lleva el valor a 99 en lugar de a 90. De este modo, un paso hacia arriba seguido de un paso hacia abajo lleva el valor a 99 en lugar de a 90. Así, un paso hacia arriba seguido de un paso hacia abajo - o viceversa - siempre aterriza en el valor inicial; 99 -> 100 -> 99.

Establecer esto hará que el cuadro de giro no tenga en cuenta el valor de singleStep, aunque se conserva para que singleStep tenga efecto si el paso decimal adaptativo se desactiva más tarde.

Véase también stepType().

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

Esta señal se emite cada vez que se cambia el texto del cuadro de giro. El nuevo texto se pasa en text con prefix() y suffix().

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

Esta función virtual es utilizada por la caja de giro siempre que necesite mostrar el value dado. La implementación por defecto devuelve una cadena que contiene value impresa usando QWidget::locale().toString(value, u'f', decimals()) y eliminará el separador de miles a menos que se establezca setGroupSeparatorShown(). Las reimplementaciones pueden devolver cualquier cosa.

Nota: QDoubleSpinBox no llama a esta función para specialValueText() y que ni prefix() ni suffix() deben incluirse en el valor de retorno.

Si reimplementa esto, puede que también necesite reimplementar valueFromText().

Véase también valueFromText() y QLocale::groupSeparator().

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

Reimplementa: QAbstractSpinBox::validate(QString &input, int &pos) const.

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

Esta señal se emite cada vez que se cambia el valor del cuadro de giro. El nuevo valor se pasa en d.

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

Esta función virtual es utilizada por el cuadro de giro siempre que necesite interpretar text introducido por el usuario como un valor.

Las subclases que necesiten mostrar los valores del cuadro de giro de forma no numérica necesitan reimplementar esta función.

Nota: QDoubleSpinBox trata specialValueText() por separado; esta función sólo se ocupa de los demás valores.

Véase también textFromValue() y validate().