Qt 是目前最先進、最完整的跨平臺C++開發(fā)工具。它不僅完全實現(xiàn)了一次編寫，所有平臺無差別運行，更提供了幾乎所有開發(fā)過程中需要用到的工具。如今，Qt已被運用于超過70個行業(yè)、數(shù)千家企業(yè)，支持?jǐn)?shù)百萬設(shè)備及應(yīng)用。

本文中的CalendarWidget示例展示了QCalendarWidget的用法。

Qt技術(shù)交流群：166830288      歡迎一起進群討論

QCalendarWidget一次顯示一個日歷月，并允許用戶選擇一個日期。日歷由四個組件組成：一個允許用戶更改顯示月份的導(dǎo)航欄、一個網(wǎng)格，其中每個單元格表示一個月中的一天，以及兩個顯示星期名稱和星期數(shù)字的標(biāo)題。

Calendar Widget示例顯示一個QCalendarWidget，并允許用戶使用QComboBoxes、QCheckBoxes和QDateEdits配置其外觀和操作，此外，用戶可以影響單個日期和標(biāo)題的格式。

QCalendarWidget的屬性總結(jié)如下：

• ：當(dāng)前選擇的日期。
• ：可以選擇的最早日期。
• ：可以選擇的最晚日期。
• ：顯示為一周的第一天的日期(通常是星期日或星期一)。
• ：是否顯示網(wǎng)格。
• ：用戶是否可以選擇日期。
• ：水平標(biāo)題中日期名稱的格式(例如，"M"， "Mon"或"Monday")。
• ：垂直頁眉的格式。
• ：是否顯示日歷小部件頂部的導(dǎo)航欄。

本示例包含一個類Window，它創(chuàng)建并布局QCalendarWidget和其他讓用戶配置QCalendarWidget的小部件。

窗口類定義

下面是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;
};

與表示自包含窗口的類一樣，大多數(shù)API都是私有的。當(dāng)我們在執(zhí)行過程中偶然發(fā)現(xiàn)私人成員時，將對其進行審查。

窗口類實現(xiàn)

現(xiàn)在讓我們回顧一下類的實現(xiàn)，從構(gòu)造函數(shù)開始：

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"));
}

我們首先使用四個私有的create…GroupBox()函數(shù)創(chuàng)建四個qgroupbox及其子部件(包括QCalendarWidget)，如下所述，然后在QGridLayout中安排組框。

我們將網(wǎng)格布局的調(diào)整大小策略設(shè)置為QLayout::SetFixedSize，以防止用戶調(diào)整窗口大小。在這種模式下，窗口的大小由QGridLayout根據(jù)其內(nèi)容小部件的大小提示自動設(shè)置。

為了確保在每次更改QCalendarWidget的屬性(例如，隱藏導(dǎo)航欄、垂直標(biāo)題或網(wǎng)格)時不會自動調(diào)整窗口的大小，我們將第0行的最小高度和第0列的最小寬度設(shè)置為QCalendarWidget的初始大小。

讓我們來看看createPreviewGroupBox()函數(shù)：

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);
}

Preview組框只包含一個小部件：QCalendarWidget，我們設(shè)置它，將它的currentPageChanged()信號連接到reformatCalendarPage()插槽，以確保每個新頁面都獲得用戶指定的格式。

createGeneralOptionsGroupBox()函數(shù)有點大，并且以相同的方式設(shè)置了幾個小部件。我們將在這里查看它的部分實現(xiàn)，并跳過其余部分：

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);
...

我們從組合框上的周開始設(shè)置開始，此組合框控制哪一天應(yīng)顯示為一周的第一天。

QComboBox類允許我們將用戶數(shù)據(jù)作為QVariant附加到每個項目，稍后可以使用QComboBox的itemData()函數(shù)檢索數(shù)據(jù)。QVariant不直接支持Qt::DayOfWeek數(shù)據(jù)類型，但它支持int, c++會很樂意將任何enum值轉(zhuǎn)換為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);
...

在創(chuàng)建了小部件之后，我們連接信號和插槽，將組合框連接到Window的私有槽或QComboBox提供的公共槽。

...
firstDayChanged(firstDayCombo->currentIndex());
selectionModeChanged(selectionModeCombo->currentIndex());
horizontalHeaderChanged(horizontalHeaderCombo->currentIndex());
verticalHeaderChanged(verticalHeaderCombo->currentIndex());
}

在函數(shù)的最后，我們調(diào)用更新日歷的槽，以確保QCalendarWidget在啟動時與其他小部件同步。

在下文中，我們將繼續(xù)介紹更多實現(xiàn)窗口類的函數(shù)，歡迎持續(xù)關(guān)注哦~

Qt Widget組件推薦

• QtitanRibbon - Ribbon UI組件：是一款遵循Microsoft Ribbon UI Paradigm for Qt技術(shù)的Ribbon UI組件，QtitanRibbon致力于為Windows、Linux和Mac OS X提供功能完整的Ribbon組件。
• QtitanChart - Qt類圖表組件：是一個C ++庫，代表一組控件，這些控件使您可以快速地為應(yīng)用程序提供漂亮而豐富的圖表。
• QtitanDataGrid - Qt網(wǎng)格組件：提供了一套完整的標(biāo)準(zhǔn) QTableView 函數(shù)和傳統(tǒng)組件無法實現(xiàn)的獨特功能。使您能夠?qū)⒉煌瑏碓吹母黝悢?shù)據(jù)加載到一個快速、靈活且功能強大的可編輯網(wǎng)格中，支持排序、分組、報告、創(chuàng)建帶狀列、拖放按鈕和許多其他方便的功能。
• QtitanDocking：允許您像 Visual Studio 一樣為您的偉大應(yīng)用程序配備可停靠面板和可停靠工具欄。黑色、白色、藍(lán)色調(diào)色板完全支持 Visual Studio 2019 主題！