Ejemplo de widget de calendario
El ejemplo del widget de calendario muestra cómo utilizar QCalendarWidget.

QCalendarWidget Muestra un mes del calendario cada vez y permite al usuario seleccionar una fecha. El calendario consta de cuatro componentes: una barra de navegación que permite al usuario cambiar el mes que se muestra, una cuadrícula en la que cada celda representa un día del mes y dos encabezados que muestran los nombres de los días de la semana y los números de semana.
El ejemplo del widget de calendario muestra un QCalendarWidget y permite al usuario configurar su apariencia y comportamiento mediante QComboBoxes, QCheckBoxes y QDateEdites. Además, el usuario puede modificar el formato de fechas y encabezados concretos.
Las propiedades del « QCalendarWidget » se resumen en la tabla siguiente.
| Propiedad | Descripción |
|---|---|
| selectedDate | La fecha seleccionada actualmente. |
| minimumDate | La fecha más temprana que se puede seleccionar. |
| maximumDate | La fecha más tardía que se puede seleccionar. |
| firstDayOfWeek | El día que se muestra como el primer día de la semana (normalmente el domingo o el lunes). |
| gridVisible | Si se debe mostrar la cuadrícula. |
| selectionMode | Si el usuario puede seleccionar una fecha o no. |
| horizontalHeaderFormat | El formato de los nombres de los días en el encabezado horizontal (por ejemplo, «M», «Mon» o «Monday»). |
| verticalHeaderFormat | El formato del encabezado vertical. |
| navigationBarVisible | Si se muestra la barra de navegación situada en la parte superior del widget de calendario. |
El ejemplo consta de una clase, ` Window`, que crea y diseña el ` QCalendarWidget ` y los demás widgets que permiten al usuario configurar el ` QCalendarWidget`.
Definición de la clase Window
Esta es la definición de la clase ` Window `:
class Window : public QWidget
{
Q_OBJECT
public:
Window(QWidget *parent = nullptr);
private slots:
void localeChanged(int index);
void firstDayChanged(int index);
void selectionModeChanged(int index);
void horizontalHeaderChanged(int index);
void verticalHeaderChanged(int index);
void selectedDateChanged();
void minimumDateChanged(QDate date);
void maximumDateChanged(QDate date);
void weekdayFormatChanged();
void weekendFormatChanged();
void reformatHeaders();
void reformatCalendarPage();
private:
void createPreviewGroupBox();
void createGeneralOptionsGroupBox();
void createDatesGroupBox();
void createTextFormatsGroupBox();
QComboBox *createColorComboBox();
QGroupBox *previewGroupBox;
QGridLayout *previewLayout;
QCalendarWidget *calendar;
QGroupBox *generalOptionsGroupBox;
QLabel *localeLabel;
QLabel *firstDayLabel;
...
QCheckBox *mayFirstCheckBox;
};Como suele ocurrir con las clases que representan ventanas autónomas, la mayor parte de la API es privada. Repasaremos los miembros privados a medida que los encontremos en la implementación.
Implementación de la clase Window
Repasemos ahora la implementación de la clase, empezando por el constructor:
Window::Window(QWidget *parent)
: QWidget(parent)
{
createPreviewGroupBox();
createGeneralOptionsGroupBox();
createDatesGroupBox();
createTextFormatsGroupBox();
QGridLayout *layout = new QGridLayout;
layout->addWidget(previewGroupBox, 0, 0);
layout->addWidget(generalOptionsGroupBox, 0, 1);
layout->addWidget(datesGroupBox, 1, 0);
layout->addWidget(textFormatsGroupBox, 1, 1);
layout->setSizeConstraint(QLayout::SetFixedSize);
setLayout(layout);
previewLayout->setRowMinimumHeight(0, calendar->sizeHint().height());
previewLayout->setColumnMinimumWidth(0, calendar->sizeHint().width());
setWindowTitle(tr("Calendar Widget"));
}Empezamos creando las cuatro « QGroupBox» y sus widgets hijos (incluido el « QCalendarWidget ») mediante cuatro funciones privadas « create...GroupBox() », que se describen a continuación. A continuación, organizamos los «group boxes» en un « QGridLayout ».
Configuramos la política de redimensionamiento del diseño de cuadrícula en « QLayout::SetFixedSize » para evitar que el usuario cambie el tamaño de la ventana. En ese modo, el tamaño de la ventana lo establece automáticamente « QGridLayout » basándose en las indicaciones de tamaño de sus widgets de contenido.
Para garantizar que la ventana no cambie de tamaño automáticamente cada vez que modifiquemos una propiedad de la QCalendarWidget (por ejemplo, al ocultar la barra de navegación, el encabezado vertical o la cuadrícula), establecemos la altura mínima de la fila 0 y la anchura mínima de la columna 0 en el tamaño inicial de la QCalendarWidget.
Pasemos ahora a la función ` createPreviewGroupBox() `:
void Window::createPreviewGroupBox()
{
previewGroupBox = new QGroupBox(tr("Preview"));
calendar = new QCalendarWidget;
calendar->setMinimumDate(QDate(1900, 1, 1));
calendar->setMaximumDate(QDate(3000, 1, 1));
calendar->setGridVisible(true);
connect(calendar, &QCalendarWidget::currentPageChanged,
this, &Window::reformatCalendarPage);
previewLayout = new QGridLayout;
previewLayout->addWidget(calendar, 0, 0, Qt::AlignCenter);
previewGroupBox->setLayout(previewLayout);
}El cuadro de grupo « Preview » contiene un único widget: el « QCalendarWidget ». Lo configuramos y conectamos su señal « currentPageChanged()» a nuestra ranura « reformatCalendarPage() » para asegurarnos de que cada nueva página adopte el formato especificado por el usuario.
La función ` createGeneralOptionsGroupBox() ` es bastante extensa y varios widgets se configuran de la misma manera. Aquí analizaremos algunas partes de su implementación y omitiremos el resto:
void Window::createGeneralOptionsGroupBox()
{
generalOptionsGroupBox = new QGroupBox(tr("General Options"));
localeCombo = new QComboBox;
int curLocaleIndex = -1;
int index = 0;
for (int _lang = QLocale::C; _lang <= QLocale::LastLanguage; ++_lang) {
QLocale::Language lang = static_cast<QLocale::Language>(_lang);
const auto locales =
QLocale::matchingLocales(lang, QLocale::AnyScript, QLocale::AnyTerritory);
for (auto loc : locales) {
QString label = QLocale::languageToString(lang);
auto territory = loc.territory();
label += QLatin1Char('/');
label += QLocale::territoryToString(territory);
if (locale().language() == lang && locale().territory() == territory)
curLocaleIndex = index;
localeCombo->addItem(label, loc);
++index;
}
}
if (curLocaleIndex != -1)
localeCombo->setCurrentIndex(curLocaleIndex);
localeLabel = new QLabel(tr("&Locale"));
localeLabel->setBuddy(localeCombo);
firstDayCombo = new QComboBox;
firstDayCombo->addItem(tr("Sunday"), Qt::Sunday);
firstDayCombo->addItem(tr("Monday"), Qt::Monday);
firstDayCombo->addItem(tr("Tuesday"), Qt::Tuesday);
firstDayCombo->addItem(tr("Wednesday"), Qt::Wednesday);
firstDayCombo->addItem(tr("Thursday"), Qt::Thursday);
firstDayCombo->addItem(tr("Friday"), Qt::Friday);
firstDayCombo->addItem(tr("Saturday"), Qt::Saturday);
firstDayLabel = new QLabel(tr("Wee&k starts on:"));
firstDayLabel->setBuddy(firstDayCombo);
...Empezamos con la configuración del cuadro combinado de « Week starts on ». Este cuadro combinado controla qué día debe mostrarse como el primer día de la semana.
La clase ` QComboBox ` nos permite adjuntar datos de usuario como un ` QVariant ` a cada elemento. Los datos se pueden recuperar posteriormente con la función ` itemData()` de ` QComboBox`. ` QVariant ` no admite directamente el tipo de datos ` Qt::DayOfWeek `, pero sí admite ` int`, y C++ convertirá sin problemas cualquier valor de enumeración a ` int`.
...
connect(localeCombo, &QComboBox::currentIndexChanged,
this, &Window::localeChanged);
connect(firstDayCombo, &QComboBox::currentIndexChanged,
this, &Window::firstDayChanged);
connect(selectionModeCombo, &QComboBox::currentIndexChanged,
this, &Window::selectionModeChanged);
connect(gridCheckBox, &QCheckBox::toggled,
calendar, &QCalendarWidget::setGridVisible);
connect(navigationCheckBox, &QCheckBox::toggled,
calendar, &QCalendarWidget::setNavigationBarVisible);
connect(horizontalHeaderCombo, &QComboBox::currentIndexChanged,
this, &Window::horizontalHeaderChanged);
connect(verticalHeaderCombo, &QComboBox::currentIndexChanged,
this, &Window::verticalHeaderChanged);
...Una vez creados los widgets, conectamos las señales y los slots. Conectamos los cuadros combinados a los slots privados de Window o a los slots públicos proporcionados por QComboBox.
...
firstDayChanged(firstDayCombo->currentIndex());
selectionModeChanged(selectionModeCombo->currentIndex());
horizontalHeaderChanged(horizontalHeaderCombo->currentIndex());
verticalHeaderChanged(verticalHeaderCombo->currentIndex());
}Al final de la función, llamamos a las ranuras que actualizan el calendario para garantizar que QCalendarWidget esté sincronizado con los demás widgets al inicio.
Veamos ahora la función privada de ` createDatesGroupBox() `:
void Window::createDatesGroupBox()
{
datesGroupBox = new QGroupBox(tr("Dates"));
minimumDateEdit = new QDateEdit;
minimumDateEdit->setDisplayFormat("MMM d yyyy");
minimumDateEdit->setDateRange(calendar->minimumDate(),
calendar->maximumDate());
minimumDateEdit->setDate(calendar->minimumDate());
minimumDateLabel = new QLabel(tr("&Minimum Date:"));
minimumDateLabel->setBuddy(minimumDateEdit);
currentDateEdit = new QDateEdit;
currentDateEdit->setDisplayFormat("MMM d yyyy");
currentDateEdit->setDate(calendar->selectedDate());
currentDateEdit->setDateRange(calendar->minimumDate(),
calendar->maximumDate());
currentDateLabel = new QLabel(tr("&Current Date:"));
currentDateLabel->setBuddy(currentDateEdit);
maximumDateEdit = new QDateEdit;
maximumDateEdit->setDisplayFormat("MMM d yyyy");
maximumDateEdit->setDateRange(calendar->minimumDate(),
calendar->maximumDate());
maximumDateEdit->setDate(calendar->maximumDate());
maximumDateLabel = new QLabel(tr("Ma&ximum Date:"));
maximumDateLabel->setBuddy(maximumDateEdit);En esta función, creamos los widgets de editor Minimum Date, Maximum Date y Current Date, que controlan las fechas mínima, máxima y seleccionada del calendario. Las fechas mínima y máxima del calendario ya se han establecido en createPrivewGroupBox(); por lo tanto, podemos establecer los valores por defecto de los widgets según los valores del calendario.
connect(currentDateEdit, &QDateEdit::dateChanged,
calendar, &QCalendarWidget::setSelectedDate);
connect(calendar, &QCalendarWidget::selectionChanged,
this, &Window::selectedDateChanged);
connect(minimumDateEdit, &QDateEdit::dateChanged,
this, &Window::minimumDateChanged);
connect(maximumDateEdit, &QDateEdit::dateChanged,
this, &Window::maximumDateChanged);
...
}Conectamos la señal dateChanged() de currentDateEdit directamente a la ranura setSelectedDate() del calendario. Cuando cambia la fecha seleccionada del calendario, ya sea como resultado de una acción del usuario o mediante programación, nuestra ranura selectedDateChanged() actualiza el editor Current Date. También debemos reaccionar cuando el usuario modifica los editores Minimum Date y Maximum Date.
Aquí está la función createTextFormatsGroup():
void Window::createTextFormatsGroupBox()
{
textFormatsGroupBox = new QGroupBox(tr("Text Formats"));
weekdayColorCombo = createColorComboBox();
weekdayColorCombo->setCurrentIndex(
weekdayColorCombo->findText(tr("Black")));
weekdayColorLabel = new QLabel(tr("&Weekday color:"));
weekdayColorLabel->setBuddy(weekdayColorCombo);
weekendColorCombo = createColorComboBox();
weekendColorCombo->setCurrentIndex(
weekendColorCombo->findText(tr("Red")));
weekendColorLabel = new QLabel(tr("Week&end color:"));
weekendColorLabel->setBuddy(weekendColorCombo);Configuramos los cuadros combinados « Weekday Color » y « Weekend Color » utilizando createColorCombo(), que crea una instancia de QComboBox y la rellena con colores («Red», «Blue», etc.).
headerTextFormatCombo = new QComboBox;
headerTextFormatCombo->addItem(tr("Bold"));
headerTextFormatCombo->addItem(tr("Italic"));
headerTextFormatCombo->addItem(tr("Plain"));
headerTextFormatLabel = new QLabel(tr("&Header text:"));
headerTextFormatLabel->setBuddy(headerTextFormatCombo);
firstFridayCheckBox = new QCheckBox(tr("&First Friday in blue"));
mayFirstCheckBox = new QCheckBox(tr("May &1 in red"));El cuadro combinado Header Text Format permite al usuario cambiar el formato de texto (negrita, cursiva o normal) utilizado para los encabezados horizontales y verticales. Las casillas de verificación First Friday in blue y May 1 in red afectan a la visualización de fechas concretas.
connect(weekdayColorCombo, &QComboBox::currentIndexChanged,
this, &Window::weekdayFormatChanged);
connect(weekdayColorCombo, &QComboBox::currentIndexChanged,
this, &Window::reformatCalendarPage);
connect(weekendColorCombo, &QComboBox::currentIndexChanged,
this, &Window::weekendFormatChanged);
connect(weekendColorCombo, &QComboBox::currentIndexChanged,
this, &Window::reformatCalendarPage);
connect(headerTextFormatCombo, &QComboBox::currentIndexChanged,
this, &Window::reformatHeaders);
connect(firstFridayCheckBox, &QCheckBox::toggled,
this, &Window::reformatCalendarPage);
connect(mayFirstCheckBox, &QCheckBox::toggled,
this, &Window::reformatCalendarPage);Conectamos las casillas de selección y los cuadros combinados a varias ranuras privadas. Las casillas de selección « First Friday in blue » y « May 1 in red » están conectadas a « reformatCalendarPage() », que también se invoca cuando el calendario cambia de mes.
...
reformatHeaders();
reformatCalendarPage();
}Al final de ` createTextFormatsGroupBox()`, llamamos a los slots privados para sincronizar ` QCalendarWidget ` con los demás widgets.
Ya hemos terminado de repasar las cuatro funciones de create...GroupBox(). Veamos ahora las demás funciones y slots privados.
QComboBox *Window::createColorComboBox()
{
QComboBox *comboBox = new QComboBox;
comboBox->addItem(tr("Red"), QColor(Qt::red));
comboBox->addItem(tr("Blue"), QColor(Qt::blue));
comboBox->addItem(tr("Black"), QColor(Qt::black));
comboBox->addItem(tr("Magenta"), QColor(Qt::magenta));
return comboBox;
}En ` createColorCombo()`, creamos un cuadro combinado y lo rellenamos con colores estándar. El segundo argumento de ` QComboBox::addItem()` es un ` QVariant ` que almacena datos de usuario (en este caso, objetos ` QColor `).
Esta función se utilizó para configurar los cuadros combinados de Weekday Color y Weekend Color.
void Window::firstDayChanged(int index)
{
calendar->setFirstDayOfWeek(Qt::DayOfWeek(
firstDayCombo->itemData(index).toInt()));
}Cuando el usuario cambia el valor del cuadro combinado « Week starts on », se invoca « firstDayChanged() » con el índice del nuevo valor del cuadro combinado. Recuperamos el elemento de datos personalizado asociado al nuevo elemento actual mediante « itemData()» y lo convertimos a un « Qt::DayOfWeek ».
selectionModeChanged(), horizontalHeaderChanged() y verticalHeaderChanged() son muy similares a firstDayChanged(), por lo que se omiten.
void Window::selectedDateChanged()
{
currentDateEdit->setDate(calendar->selectedDate());
}El selectedDateChanged() actualiza el editor Current Date para reflejar el estado actual del QCalendarWidget.
void Window::minimumDateChanged(QDate date)
{
calendar->setMinimumDate(date);
maximumDateEdit->setDate(calendar->maximumDate());
}Cuando el usuario cambia la fecha mínima, se lo comunicamos al QCalenderWidget. También actualizamos el editor Maximum Date, ya que si la nueva fecha mínima es posterior a la fecha máxima actual, QCalendarWidget adaptará automáticamente su fecha máxima para evitar un estado contradictorio.
void Window::maximumDateChanged(QDate date)
{
calendar->setMaximumDate(date);
minimumDateEdit->setDate(calendar->minimumDate());
}maximumDateChanged() Se implementa de forma similar a minimumDateChanged().
void Window::weekdayFormatChanged()
{
QTextCharFormat format;
format.setForeground(qvariant_cast<QColor>(
weekdayColorCombo->itemData(weekdayColorCombo->currentIndex())));
calendar->setWeekdayTextFormat(Qt::Monday, format);
calendar->setWeekdayTextFormat(Qt::Tuesday, format);
calendar->setWeekdayTextFormat(Qt::Wednesday, format);
calendar->setWeekdayTextFormat(Qt::Thursday, format);
calendar->setWeekdayTextFormat(Qt::Friday, format);
}Cada elemento del cuadro combinado tiene un objeto ` QColor ` como datos de usuario que se corresponden con el texto del elemento. Tras obtener los colores de los cuadros combinados, establecemos el formato de texto de cada día de la semana.
El formato de texto de una columna del calendario se especifica mediante un objeto ` QTextCharFormat`, que, además del color de primer plano, nos permite indicar diversa información de formato de caracteres. En este ejemplo, solo mostramos un subconjunto de las posibilidades.
void Window::weekendFormatChanged()
{
QTextCharFormat format;
format.setForeground(qvariant_cast<QColor>(
weekendColorCombo->itemData(weekendColorCombo->currentIndex())));
calendar->setWeekdayTextFormat(Qt::Saturday, format);
calendar->setWeekdayTextFormat(Qt::Sunday, format);
}weekendFormatChanged() es igual que weekdayFormatChanged(), salvo que afecta al sábado y al domingo en lugar de de lunes a viernes.
void Window::reformatHeaders()
{
QString text = headerTextFormatCombo->currentText();
QTextCharFormat format;
if (text == tr("Bold"))
format.setFontWeight(QFont::Bold);
else if (text == tr("Italic"))
format.setFontItalic(true);
else if (text == tr("Green"))
format.setForeground(Qt::green);
calendar->setHeaderTextFormat(format);
}La ranura « reformatHeaders() » se activa cuando el usuario cambia el formato de texto de los encabezados. Comparamos el texto actual del cuadro combinado « Header Text Format » para determinar qué formato aplicar. (Una alternativa habría sido almacenar los valores de « QTextCharFormat » junto con los elementos del cuadro combinado.)
void Window::reformatCalendarPage()
{
QTextCharFormat mayFirstFormat;
const QDate mayFirst(calendar->yearShown(), 5, 1);
QTextCharFormat firstFridayFormat;
QDate firstFriday(calendar->yearShown(), calendar->monthShown(), 1);
while (firstFriday.dayOfWeek() != Qt::Friday)
firstFriday = firstFriday.addDays(1);
if (firstFridayCheckBox->isChecked()) {
firstFridayFormat.setForeground(Qt::blue);
} else { // Revert to regular colour for this day of the week.
Qt::DayOfWeek dayOfWeek(static_cast<Qt::DayOfWeek>(firstFriday.dayOfWeek()));
firstFridayFormat.setForeground(calendar->weekdayTextFormat(dayOfWeek).foreground());
}
calendar->setDateTextFormat(firstFriday, firstFridayFormat);
// When it is checked, "May First in Red" always takes precedence over "First Friday in Blue".
if (mayFirstCheckBox->isChecked()) {
mayFirstFormat.setForeground(Qt::red);
} else if (!firstFridayCheckBox->isChecked() || firstFriday != mayFirst) {
// We can now be certain we won't be resetting "May First in Red" when we restore
// may 1st's regular colour for this day of the week.
Qt::DayOfWeek dayOfWeek(static_cast<Qt::DayOfWeek>(mayFirst.dayOfWeek()));
calendar->setDateTextFormat(mayFirst, calendar->weekdayTextFormat(dayOfWeek));
}
calendar->setDateTextFormat(mayFirst, mayFirstFormat);
}En ` reformatCalendarPage()`, establecemos el formato de texto del primer viernes del mes y del 1 de mayo del año en curso. Los formatos de texto que se utilizan realmente dependen de qué casillas de selección estén marcadas y de cuáles sean los formatos de días laborables y fines de semana.
QCalendarWidget Nos permite establecer el formato de texto de fechas concretas mediante setDateTextFormat(). Hemos optado por establecer los formatos de fecha cuando cambia la página del calendario —es decir, cuando se muestra un nuevo mes— y cuando se modifica el formato de días laborables y fines de semana. Comprobamos cuáles de las opciones mayFirstCheckBox y firstDayCheckBox, si las hay, están marcadas y establecemos los formatos de texto en consecuencia.
© 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.