Ejemplo de cuadros de selección
El ejemplo de los cuadros giratorios muestra cómo utilizar los distintos tipos de cuadros giratorios disponibles en Qt, desde un sencillo widget ` QSpinBox ` hasta editores más complejos como el widget ` QDateTimeEdit `.

El ejemplo consta de una única clase ` Window ` que se utiliza para mostrar los diferentes widgets basados en cuadros giratorios disponibles en Qt.
Definición de la clase Window
La clase ` Window ` hereda de ` QWidget ` y contiene dos ranuras que se utilizan para proporcionar funciones interactivas:
class Window : public QWidget
{
Q_OBJECT
public:
Window(QWidget *parent = nullptr);
public slots:
void changePrecision(int decimals);
void setFormatString(const QString &formatString);
private:
void createSpinBoxes();
void createDateTimeEdits();
void createDoubleSpinBoxes();
QDateTimeEdit *meetingEdit;
QDoubleSpinBox *doubleSpinBox;
QDoubleSpinBox *priceSpinBox;
QDoubleSpinBox *scaleSpinBox;
QGroupBox *spinBoxesGroup;
QGroupBox *editsGroup;
QGroupBox *doubleSpinBoxesGroup;
QLabel *meetingLabel;
QSpinBox *groupSeparatorSpinBox;
QDoubleSpinBox *groupSeparatorSpinBox_d;
};Las funciones privadas se utilizan para configurar cada tipo de cuadro giratorio en la ventana. Utilizamos variables de miembro para llevar un registro de los distintos widgets, de modo que puedan reconfigurarse cuando sea necesario.
Implementación de la clase de ventana
El constructor simplemente llama a funciones privadas para configurar los diferentes tipos de cuadros giratorios utilizados en el ejemplo y coloca cada grupo en un diseño:
Window::Window(QWidget *parent)
: QWidget(parent)
{
createSpinBoxes();
createDateTimeEdits();
createDoubleSpinBoxes();
QHBoxLayout *layout = new QHBoxLayout;
layout->addWidget(spinBoxesGroup);
layout->addWidget(editsGroup);
layout->addWidget(doubleSpinBoxesGroup);
setLayout(layout);
setWindowTitle(tr("Spin Boxes"));
}Utilizamos el diseño para gestionar la disposición de los widgets hijos de la ventana y cambiar el título de la ventana.
La función ` createSpinBoxes() ` crea un ` QGroupBox ` y coloca en su interior tres widgets ` QSpinBox ` con etiquetas descriptivas que indican los tipos de entrada que esperan.
void Window::createSpinBoxes()
{
spinBoxesGroup = new QGroupBox(tr("Spinboxes"));
QLabel *integerLabel = new QLabel(tr("Enter a value between "
"%1 and %2:").arg(-20).arg(20));
QSpinBox *integerSpinBox = new QSpinBox;
integerSpinBox->setRange(-20, 20);
integerSpinBox->setSingleStep(1);
integerSpinBox->setValue(0);El primer cuadro giratorio muestra la forma más sencilla de utilizar ` QSpinBox`. Acepta valores entre -20 y 20; el valor actual se puede aumentar o disminuir en 1 mediante los botones de flecha o las teclas ` Up ` y ` Down `, y el valor por defecto es 0.
El segundo cuadro giratorio utiliza un incremento mayor y muestra un sufijo para proporcionar más información sobre el tipo de datos que representa el número:
QLabel *zoomLabel = new QLabel(tr("Enter a zoom value between "
"%1 and %2:").arg(0).arg(1000));
QSpinBox *zoomSpinBox = new QSpinBox;
zoomSpinBox->setRange(0, 1000);
zoomSpinBox->setSingleStep(10);
zoomSpinBox->setSuffix("%");
zoomSpinBox->setSpecialValueText(tr("Automatic"));
zoomSpinBox->setValue(100);Este cuadro giratorio también muestra « special value » en lugar del valor mínimo definido para él. Esto significa que nunca mostrará « 0% », pero sí mostrará « Automatic » cuando se seleccione el valor mínimo.
El tercer cuadro de selección muestra cómo se puede utilizar un prefijo:
QLabel *priceLabel = new QLabel(tr("Enter a price between "
"%1 and %2:").arg(0).arg(999));
QSpinBox *priceSpinBox = new QSpinBox;
priceSpinBox->setRange(0, 999);
priceSpinBox->setSingleStep(1);
priceSpinBox->setPrefix("$");
priceSpinBox->setValue(99);Para simplificar, mostramos un cuadro giratorio con un prefijo y sin sufijo. También es posible utilizar ambos a la vez.
groupSeparatorSpinBox = new QSpinBox;
groupSeparatorSpinBox->setRange(-99999999, 99999999);
groupSeparatorSpinBox->setValue(1000);
groupSeparatorSpinBox->setGroupSeparatorShown(true);
QCheckBox *groupSeparatorChkBox = new QCheckBox;
groupSeparatorChkBox->setText(tr("Show group separator"));
groupSeparatorChkBox->setChecked(true);
connect(groupSeparatorChkBox, &QCheckBox::toggled, groupSeparatorSpinBox,
&QSpinBox::setGroupSeparatorShown);
QLabel *hexLabel = new QLabel(tr("Enter a value between "
"%1 and %2:").arg('-' + QString::number(31, 16)).arg(QString::number(31, 16)));
QSpinBox *hexSpinBox = new QSpinBox;
hexSpinBox->setRange(-31, 31);
hexSpinBox->setSingleStep(1);
hexSpinBox->setValue(0);
hexSpinBox->setDisplayIntegerBase(16);
QVBoxLayout *spinBoxLayout = new QVBoxLayout;
spinBoxLayout->addWidget(integerLabel);
spinBoxLayout->addWidget(integerSpinBox);
spinBoxLayout->addWidget(zoomLabel);
spinBoxLayout->addWidget(zoomSpinBox);
spinBoxLayout->addWidget(priceLabel);
spinBoxLayout->addWidget(priceSpinBox);
spinBoxLayout->addWidget(hexLabel);
spinBoxLayout->addWidget(hexSpinBox);
spinBoxLayout->addWidget(groupSeparatorChkBox);
spinBoxLayout->addWidget(groupSeparatorSpinBox);
spinBoxesGroup->setLayout(spinBoxLayout);
}El resto de la función configura un diseño para el cuadro de grupo y coloca cada uno de los controles en su interior.
La función « createDateTimeEdits() » crea otro cuadro de grupo con una selección de cuadros giratorios que se utilizan para editar fechas y horas.
void Window::createDateTimeEdits()
{
editsGroup = new QGroupBox(tr("Date and time spin boxes"));
QLabel *dateLabel = new QLabel;
QDateEdit *dateEdit = new QDateEdit(QDate::currentDate());
dateEdit->setDateRange(QDate(2005, 1, 1), QDate(2010, 12, 31));
dateLabel->setText(tr("Appointment date (between %0 and %1):")
.arg(dateEdit->minimumDate().toString(Qt::ISODate))
.arg(dateEdit->maximumDate().toString(Qt::ISODate)));El primer cuadro giratorio es un widget « QDateEdit » capaz de aceptar fechas dentro de un intervalo determinado especificado mediante valores de « QDate ». Los botones de flecha y las teclas « Up » y « Down » pueden utilizarse para aumentar y disminuir los valores de año, mes y día cuando el cursor se encuentra en la sección correspondiente.
El segundo cuadro giratorio es un widget QTimeEdit:
QLabel *timeLabel = new QLabel;
QTimeEdit *timeEdit = new QTimeEdit(QTime::currentTime());
timeEdit->setTimeRange(QTime(9, 0, 0, 0), QTime(16, 30, 0, 0));
timeLabel->setText(tr("Appointment time (between %0 and %1):")
.arg(timeEdit->minimumTime().toString(Qt::ISODate))
.arg(timeEdit->maximumTime().toString(Qt::ISODate)));Los valores aceptables para la hora se definen mediante valores de « QTime ».
El tercer cuadro giratorio es un widget « QDateTimeEdit » que puede mostrar tanto valores de fecha como de hora, y colocamos una etiqueta encima para indicar el intervalo de horas permitidas para una reunión. Estos widgets se actualizarán cuando el usuario cambie una cadena de formato.
meetingLabel = new QLabel;
meetingEdit = new QDateTimeEdit(QDateTime::currentDateTime());La cadena de formato utilizada para el editor de fecha y hora, que también aparece en la cadena mostrada por la etiqueta, se selecciona de un conjunto de cadenas en un cuadro combinado:
QLabel *formatLabel = new QLabel(tr("Format string for the meeting date "
"and time:"));
QComboBox *formatComboBox = new QComboBox;
formatComboBox->addItem("yyyy-MM-dd hh:mm:ss (zzz 'ms')");
formatComboBox->addItem("hh:mm:ss MM/dd/yyyy");
formatComboBox->addItem("hh:mm:ss dd/MM/yyyy");
formatComboBox->addItem("hh:mm:ss");
formatComboBox->addItem("hh:mm ap");
connect(formatComboBox, &QComboBox::textActivated,
this, &Window::setFormatString);Una señal de este cuadro combinado está conectada a una ranura de la clase « Window » (que se muestra más adelante).
QVBoxLayout *editsLayout = new QVBoxLayout;
editsLayout->addWidget(dateLabel);
editsLayout->addWidget(dateEdit);
editsLayout->addWidget(timeLabel);
editsLayout->addWidget(timeEdit);
editsLayout->addWidget(meetingLabel);
editsLayout->addWidget(meetingEdit);
editsLayout->addWidget(formatLabel);
editsLayout->addWidget(formatComboBox);
editsGroup->setLayout(editsLayout);
}Cada widget secundario del cuadro de grupo se coloca en un diseño.
La ranura de ` setFormatString() ` se activa cada vez que el usuario selecciona una nueva cadena de formato en el cuadro combinado. El formato de visualización del widget ` QDateTimeEdit ` se establece utilizando la cadena sin formato pasada por la señal:
void Window::setFormatString(const QString &formatString)
{
meetingEdit->setDisplayFormat(formatString);En función de las secciones visibles en el widget, establecemos un nuevo intervalo de fecha u hora y actualizamos la etiqueta asociada para proporcionar información relevante al usuario:
if (meetingEdit->displayedSections() & QDateTimeEdit::DateSections_Mask) {
meetingEdit->setDateRange(QDate(2004, 11, 1), QDate(2005, 11, 30));
meetingLabel->setText(tr("Meeting date (between %0 and %1):")
.arg(meetingEdit->minimumDate().toString(Qt::ISODate))
.arg(meetingEdit->maximumDate().toString(Qt::ISODate)));
} else {
meetingEdit->setTimeRange(QTime(0, 7, 20, 0), QTime(21, 0, 0, 0));
meetingLabel->setText(tr("Meeting time (between %0 and %1):")
.arg(meetingEdit->minimumTime().toString(Qt::ISODate))
.arg(meetingEdit->maximumTime().toString(Qt::ISODate)));
}
}Cuando se cambia la cadena de formato, aparecerá la etiqueta y el widget de entrada adecuados para fechas, horas o ambos tipos de entrada.
La función ` createDoubleSpinBoxes() ` crea tres cuadros de selección que se utilizan para introducir números de coma flotante de doble precisión:
void Window::createDoubleSpinBoxes()
{
doubleSpinBoxesGroup = new QGroupBox(tr("Double precision spinboxes"));
QLabel *precisionLabel = new QLabel(tr("Number of decimal places "
"to show:"));
QSpinBox *precisionSpinBox = new QSpinBox;
precisionSpinBox->setRange(0, 100);
precisionSpinBox->setValue(2);Antes de crear los widgets de la función ` QDoubleSpinBox `, creamos un cuadro giratorio para controlar el número de decimales que se muestran. Por defecto, solo se muestran dos decimales en los siguientes cuadros giratorios, cada uno de los cuales es equivalente a un cuadro giratorio del grupo creado por la función ` createSpinBoxes() `.
El primer cuadro de selección doble muestra un cuadro de selección básico de doble precisión con el mismo rango, tamaño de paso y valor por defecto que el primer cuadro de selección de la función ` createSpinBoxes() `:
QLabel *doubleLabel = new QLabel(tr("Enter a value between "
"%1 and %2:").arg(-20).arg(20));
doubleSpinBox = new QDoubleSpinBox;
doubleSpinBox->setRange(-20.0, 20.0);
doubleSpinBox->setSingleStep(1.0);
doubleSpinBox->setValue(0.0);Sin embargo, este cuadro de selección también permite introducir valores no enteros.
El segundo cuadro de selección muestra un sufijo y presenta un valor especial en lugar del valor mínimo:
QLabel *scaleLabel = new QLabel(tr("Enter a scale factor between "
"%1 and %2:").arg(0).arg(1000.0));
scaleSpinBox = new QDoubleSpinBox;
scaleSpinBox->setRange(0.0, 1000.0);
scaleSpinBox->setSingleStep(10.0);
scaleSpinBox->setSuffix("%");
scaleSpinBox->setSpecialValueText(tr("No scaling"));
scaleSpinBox->setValue(100.0);El tercer cuadro de selección muestra un prefijo en lugar de un sufijo:
QLabel *priceLabel = new QLabel(tr("Enter a price between "
"%1 and %2:").arg(0).arg(1000));
priceSpinBox = new QDoubleSpinBox;
priceSpinBox->setRange(0.0, 1000.0);
priceSpinBox->setSingleStep(1.0);
priceSpinBox->setPrefix("$");
priceSpinBox->setValue(99.99);
connect(precisionSpinBox, &QSpinBox::valueChanged,Conectamos el widget « QSpinBox », que especifica la precisión, a una ranura de la clase « Window ».
QVBoxLayout *spinBoxLayout = new QVBoxLayout;
spinBoxLayout->addWidget(precisionLabel);
spinBoxLayout->addWidget(precisionSpinBox);
spinBoxLayout->addWidget(doubleLabel);
spinBoxLayout->addWidget(doubleSpinBox);
spinBoxLayout->addWidget(scaleLabel);
spinBoxLayout->addWidget(scaleSpinBox);
spinBoxLayout->addWidget(priceLabel);
spinBoxLayout->addWidget(priceSpinBox);
spinBoxLayout->addWidget(groupSeparatorChkBox);
spinBoxLayout->addWidget(groupSeparatorSpinBox_d);
doubleSpinBoxesGroup->setLayout(spinBoxLayout);
}El resto de la función coloca cada uno de los widgets en un diseño para el cuadro de grupo.
La ranura « changePrecision() » se activa cuando el usuario cambia el valor en el cuadro giratorio de precisión:
void Window::changePrecision(int decimals)
{
doubleSpinBox->setDecimals(decimals);
scaleSpinBox->setDecimals(decimals);
priceSpinBox->setDecimals(decimals);
}Esta función simplemente utiliza el número entero proporcionado por la señal para especificar el número de decimales en cada uno de los widgets « QDoubleSpinBox ». Cada uno de ellos se actualizará automáticamente cuando se modifique su propiedad « decimals ».
© 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.