QSpinBox Class

Documentación de funciones miembro

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

Construye una caja giratoria con 0 como valor mínimo y 99 como valor máximo, un valor de paso de 1. El valor se establece inicialmente en 0. Se emparenta con parent.

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

[virtual noexcept] QSpinBox::~QSpinBox()

Destructor.

[override virtual protected] bool QSpinBox::event(QEvent *event)

Reimplementa: QAbstractSpinBox::event(QEvent *event).

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

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

void QSpinBox::setRange(int minimum, int maximum)

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

setRange(minimum, maximum);

es equivalente a:

setMinimum(minimum);
setMaximum(maximum);

Véase también minimum y maximum.

void QSpinBox::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.

La dirección del paso se tiene en cuenta para manejar los casos extremos, de modo que bajar de 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. Por lo tanto, 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 QSpinBox::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 protected] QString QSpinBox::textFromValue(int value) const

Esta función virtual es utilizada por el cuadro de giro siempre que necesite mostrar el value dado. La implementación por defecto devuelve una cadena que contiene value impresa de la forma estándar utilizando QWidget::locale().toString(), pero con el separador de miles eliminado a menos que se establezca setGroupSeparatorShown(). Las reimplementaciones pueden devolver cualquier cosa. (Véase el ejemplo en la descripción detallada).

Nota: QSpinBox 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() y validate().

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

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

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

[signal] void QSpinBox::valueChanged(int i)

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

[virtual protected] int QSpinBox::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: QSpinBox trata specialValueText() por separado; esta función sólo se ocupa de los demás valores.

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