En esta página

QDoubleSpinBox Class

La clase QDoubleSpinBox ofrece un control de tipo «spin box» que admite valores de tipo double. Más información...

Encabezado: #include <QDoubleSpinBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredan: QAbstractSpinBox

Propiedades

Funciones públicas

QDoubleSpinBox(QWidget *parent = nullptr)
virtual ~QDoubleSpinBox()
QString cleanText() const
int decimals() const
double maximum() const
double minimum() const
QString prefix() const
void setDecimals(int prec)
void setMaximum(double max)
void setMinimum(double min)
void setPrefix(const QString &prefix)
void setRange(double minimum, double maximum)
void setSingleStep(double val)
void setStepType(QAbstractSpinBox::StepType stepType)
void setSuffix(const QString &suffix)
double singleStep() const
QAbstractSpinBox::StepType stepType() const
QString suffix() const
virtual QString textFromValue(double value) const
double value() const
virtual double valueFromText(const QString &text) const

Funciones públicas reimplementadas

virtual void fixup(QString &input) const override
virtual QValidator::State validate(QString &text, int &pos) const override

Ranuras públicas

void setValue(double val)

Señales

void textChanged(const QString &text)
void valueChanged(double d)

Descripción detallada

Cuadro giratorio que muestra un doble

QDoubleSpinBox permite al usuario seleccionar un valor haciendo clic en los botones de arriba y abajo o pulsando las teclas «Arriba» o «Abajo» del teclado para aumentar o disminuir el valor que se muestra actualmente. El usuario también puede introducir el valor manualmente. El cuadro de selección admite valores de doble precisión, pero se puede ampliar para utilizar diferentes cadenas mediante validate(), textFromValue() y valueFromText().

Cada vez que cambia el valor, QDoubleSpinBox emite las señales valueChanged() y textChanged(), la primera de las cuales proporciona un valor de tipo double y la segunda, un valor de tipo QString. La señal textChanged() proporciona el valor con prefix() y suffix(). El valor actual se puede obtener con value() y establecer con setValue().

Nota: QDoubleSpinBox redondeará los números para que se puedan mostrar con la precisión actual. En un QDoubleSpinBox con el número de decimales establecido en 2, al llamar a setValue(2.555), value() devolverá 2.56.

Al hacer clic en los botones de arriba y abajo, o al utilizar las teclas de flecha arriba y abajo del teclado, se aumentará o disminuirá el valor actual en incrementos del tamaño singleStep(). Si desea modificar este comportamiento, puede reimplementar la función virtual ` stepBy()`. Los valores mínimo y máximo, así como el tamaño del incremento, se pueden establecer mediante uno de los constructores y modificarse posteriormente con ` setMinimum()`, ` setMaximum()` y ` setSingleStep()`. El cuadro giratorio tiene una precisión predeterminada de dos decimales, pero esto se puede cambiar mediante ` setDecimals()`.

La mayoría de los spinbox son direccionales, pero QDoubleSpinBox también puede funcionar como un spinbox circular; es decir, si el rango es 0,0-99,9 y el valor actual es 99,9, al hacer clic en «arriba» se obtendrá 0 si wrapping() está establecido en true. Utiliza setWrapping() si deseas un comportamiento circular.

El valor mostrado puede ir precedido o seguido de cadenas arbitrarias que indiquen, por ejemplo, la moneda o la unidad de medida. Consulta setPrefix() y setSuffix(). El texto del cuadro giratorio se recupera con text() (que incluye cualquier prefix() y suffix()), o con cleanText() (que no incluye prefix(), ni suffix(), ni espacios en blanco al principio ni al final).

A menudo resulta conveniente ofrecer al usuario una opción especial (normalmente predeterminada) además del rango de valores numéricos. Consulte setSpecialValueText() para saber cómo hacerlo con QDoubleSpinBox.

Nota: El valor mostrado por el QDoubleSpinBox está limitado a 18 caracteres, además del contenido eventual del prefijo y el sufijo. Esta limitación se utiliza para que el cuadro de selección doble siga siendo utilizable incluso con valores extremadamente grandes.

Véase también QSpinBox, QDateTimeEdit, QSlider y el ejemplo de cuadros de selección.

Documentación de propiedades

[read-only] cleanText : QString

Esta propiedad contiene el texto del cuadro de selección, sin incluir ningún prefijo, sufijo ni espacios en blanco al principio o al final.

Funciones de acceso:

QString cleanText() const

Véase también text, QDoubleSpinBox::prefix y QDoubleSpinBox::suffix.

decimals : int

Esta propiedad define la precisión del cuadro de selección, en decimales

Establece el número de decimales que utilizará el cuadro de selección para mostrar e interpretar valores de tipo «double».

Advertencia: El valor máximo de « decimals » es DBL_MAX_10_EXP + DBL_DIG (es decir, 323) debido a las limitaciones del tipo «double».

Nota: Los valores máximo, mínimo y actual pueden variar como consecuencia de modificar esta propiedad.

Funciones de acceso:

int decimals() const
void setDecimals(int prec)

maximum : double

Esta propiedad contiene el valor máximo del cuadro de selección

Al configurar esta propiedad, se ajusta el « minimum » si es necesario, para garantizar que el rango siga siendo válido.

El valor máximo por defecto es 99,99.

Nota: El valor máximo se redondeará para que coincida con la propiedad «decimals».

Funciones de acceso:

double maximum() const
void setMaximum(double max)

Véase también « decimals » y « setRange()».

minimum : double

Esta propiedad contiene el valor mínimo del cuadro de selección

Al configurar esta propiedad, el « maximum » se ajusta, si es necesario, para garantizar que el rango siga siendo válido.

El valor mínimo por defecto es 0,0.

Nota: El valor mínimo se redondeará para que coincida con la propiedad «decimals».

Funciones de acceso:

double minimum() const
void setMinimum(double min)

Véase también « decimals », « setRange()» y « specialValueText ».

prefix : QString

Esta propiedad contiene el prefijo del cuadro de selección

El prefijo se añade al principio del valor mostrado. Se suele utilizar para mostrar una unidad de medida o un símbolo monetario. Por ejemplo:

spinbox->setPrefix("$");

Para desactivar la visualización del prefijo, establece esta propiedad en una cadena vacía. El valor por defecto es sin prefijo. El prefijo no se muestra cuando value() == minimum() y specialValueText() está activado.

Si no se ha establecido ningún prefijo, prefix() devuelve una cadena vacía.

Funciones de acceso:

QString prefix() const
void setPrefix(const QString &prefix)

Véanse también suffix(), setSuffix(), specialValueText() y setSpecialValueText().

singleStep : double

Esta propiedad contiene el valor del paso

Cuando el usuario utilice las flechas para modificar el valor del cuadro giratorio, este se incrementará o disminuirá en la cantidad especificada en singleStep. El valor por defecto es 1,0. Establecer un valor de singleStep inferior a 0 no tiene ningún efecto.

Funciones de acceso:

double singleStep() const
void setSingleStep(double val)

stepType : StepType

Esta propiedad indica el tipo de paso.

El tipo de paso puede ser un paso único o un paso decimal adaptativo.

Funciones de acceso:

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

suffix : QString

Esta propiedad contiene el sufijo del cuadro de selección

El sufijo se añade al final del valor mostrado. Su uso más habitual es mostrar una unidad de medida o un símbolo monetario. Por ejemplo:

spinbox->setSuffix(" km");

Para desactivar la visualización del sufijo, establece esta propiedad en una cadena vacía. Por defecto, no se muestra ningún sufijo. El sufijo no se muestra para el campo de selección de fecha y hora ( minimum()) si se ha establecido la opción « specialValueText()».

Si no se establece ningún sufijo, suffix() devuelve una cadena vacía.

Funciones de acceso:

QString suffix() const
void setSuffix(const QString &suffix)

Véanse también prefix(), setPrefix(), specialValueText() y setSpecialValueText().

value : double

Esta propiedad contiene el valor del cuadro de selección

setValue() emitirá una señal « valueChanged()» si el nuevo valor es diferente del anterior. La propiedad «value» tiene una segunda señal de notificación que incluye el prefijo y el sufijo del cuadro de selección.

Nota: El valor se redondeará para que pueda mostrarse con la configuración actual de decimales.

Funciones de acceso:

double value() const
void setValue(double val)

Señal de notificación:

void valueChanged(double d)

Véase también decimals.

Documentación de funciones de miembro

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

Crea un cuadro de selección con un valor mínimo de 0,0 y un valor máximo de 99,99, un incremento de 1,0 y una precisión de 2 decimales. El valor inicial es 0,00. El cuadro de selección tiene la propiedad « parent » especificada.

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 práctica para establecer los valores de « minimum » y « maximum » con una sola llamada a la función.

Nota: Los valores máximo y mínimo se redondearán para ajustarse a la propiedad «decimals».

setRange(minimum, maximum);

equivale a:

setMinimum(minimum);
setMaximum(maximum);

Véase también minimum y maximum.

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

Establece el tipo de paso del cuadro de selección en « stepType », que corresponde a un paso único o a un paso decimal adaptativo.

El paso decimal adaptativo significa que el tamaño del paso se ajustará continuamente a una potencia de diez inferior al valor actual de « value ». Así, cuando el valor es 1100, el paso se establece en 100, por lo que al aumentar un paso se pasa a 1200. Si el valor es 1200, al aumentar un paso se pasa a 1300. En el caso de los valores negativos, al reducir el paso desde -1100 se pasa a -1200.

También funciona con cualquier valor decimal: 0,041 se incrementa a 0,042 con un solo paso.

Se tiene en cuenta la dirección del paso para gestionar los casos límite, de modo que al bajar un paso desde 100, el valor pasa a 99 en lugar de a 90. Así, un paso hacia arriba seguido de uno hacia abajo —o viceversa— siempre vuelve al valor inicial: 99 -> 100 -> 99.

Al configurar esto, el cuadro de selección ignorará el valor de ` singleStep`, aunque este se conserva para que ` singleStep ` surta efecto si posteriormente se desactiva el paso decimal adaptativo.

Nota: Funciónde asignación para la propiedad stepType.

Véase también stepType().

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

Esta señal se emite cada vez que se modifica el texto del cuadro de selección. El nuevo texto se pasa mediante ` text ` con ` prefix()` y ` suffix()`.

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

El cuadro de selección «spin box» utiliza esta función virtual siempre que necesita mostrar el valor de value. La implementación por defecto devuelve una cadena que contiene value, impresa mediante QWidget::locale().toString(value, u'f', decimals()) y eliminará el separador de miles a menos que se haya establecido setGroupSeparatorShown(). Las reimplementaciones pueden devolver cualquier valor.

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

Si reimplementas esto, es posible que también tengas que reimplementar valueFromText().

Véanse 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 modifica el valor del cuadro de selección. El nuevo valor se transmite en ` d`.

Nota: Señalde notificación para la propiedad value.

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

El cuadro de selección utiliza esta función virtual cada vez que necesita interpretar un text o introducido por el usuario como un valor.

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

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

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

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.