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

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

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

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

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

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

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

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

窗口類(lèi)定義

下面是Window類(lèi)的定義：

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

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

窗口類(lèi)實(shí)現(xiàn)

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

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

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

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

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

讓我們來(lái)看看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組框只包含一個(gè)小部件：QCalendarWidget，我們?cè)O(shè)置它，將它的currentPageChanged()信號(hào)連接到reformatCalendarPage()插槽，以確保每個(gè)新頁(yè)面都獲得用戶(hù)指定的格式。

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

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

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

QComboBox類(lèi)允許我們將用戶(hù)數(shù)據(jù)作為QVariant附加到每個(gè)項(xiàng)目，稍后可以使用QComboBox的itemData()函數(shù)檢索數(shù)據(jù)。QVariant不直接支持Qt::DayOfWeek數(shù)據(jù)類(lèi)型，但它支持int, c++會(huì)很樂(lè)意將任何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)建了小部件之后，我們連接信號(hào)和插槽，將組合框連接到Window的私有槽或QComboBox提供的公共槽。

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

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

在下文中，我們將繼續(xù)介紹更多實(shí)現(xiàn)窗口類(lèi)的函數(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類(lèi)圖表組件：是一個(gè)C ++庫(kù)，代表一組控件，這些控件使您可以快速地為應(yīng)用程序提供漂亮而豐富的圖表。
• QtitanDataGrid - Qt網(wǎng)格組件：提供了一套完整的標(biāo)準(zhǔn) QTableView 函數(shù)和傳統(tǒng)組件無(wú)法實(shí)現(xiàn)的獨(dú)特功能。使您能夠?qū)⒉煌瑏?lái)源的各類(lèi)數(shù)據(jù)加載到一個(gè)快速、靈活且功能強(qiáng)大的可編輯網(wǎng)格中，支持排序、分組、報(bào)告、創(chuàng)建帶狀列、拖放按鈕和許多其他方便的功能。
• QtitanDocking：允許您像 Visual Studio 一樣為您的偉大應(yīng)用程序配備可?？棵姘搴涂赏？抗ぞ邫?。黑色、白色、藍(lán)色調(diào)色板完全支持 Visual Studio 2019 主題！