Qt 富文本处理（25）：Calendar Example【来自官档的翻译】

前言

 日历案例显示了如何创建富文本内容并使用富文本编辑器显示它。

具体而言，该示例演示了以下内容：

• 将文本编辑器与文本文档一起使用

• 将表格和框架插入文档

• 在表中导航

• 插入不同样式的文字

用于显示文档的富文本编辑器在主窗口应用程序中使用。

MainWindow类定义

  MainWindow类提供了一个文本编辑器小部件和一些控件，以允许用户更改显示的月份和年份。 用于文本的字体大小也可以调整。

 class MainWindow : public QMainWindow
 {
     Q_OBJECT

 public:
     MainWindow();

 public slots:
     void setFontSize(int size);
     void setMonth(int month);
     void setYear(QDate date);

 private:
     void insertCalendar();

     int fontSize;
     QDate selectedDate;
     QTextBrowser *editor;
 };

  私有insertCalendar( )函数依靠fontSize和selectedDate变量执行大部分工作，以向编辑器中写入有用的信息。

MainWindow类实现

  MainWindow构造函数设置用户界面并初始化用于生成每月日历的变量。

 MainWindow::MainWindow()
 {
     selectedDate = QDate::currentDate();
     fontSize = 10;

     QWidget *centralWidget = new QWidget;

  首先，为所选日期设置默认值，该默认值将在日历中突出显示，并使用要使用的字体大小。 由于我们将QMainWindow用于用户界面，因此我们构造了一个小部件以用作中央小部件。
  用户界面将在生成的日历上方包括一行控件； 我们构造一个标签和一个组合框以选择月份，并为年份设置一个旋转框。 这些小部件配置为提供合理范围的值供用户尝试：

     QLabel *dateLabel = new QLabel(tr("Date:"));
     QComboBox *monthCombo = new QComboBox;

     for (int month = 1; month <= 12; ++month)
         monthCombo->addItem(QLocale::system().monthName(month));

     QDateTimeEdit *yearEdit = new QDateTimeEdit;
     yearEdit->setDisplayFormat("yyyy");
     yearEdit->setDateRange(QDate(1753, 1, 1), QDate(8000, 1, 1));

     monthCombo->setCurrentIndex(selectedDate.month()-1);
     yearEdit->setDate(selectedDate);

我们使用selectedDate对象获取当前月份和年份，并在组合框和旋转框中设置它们：
字体大小显示在旋转框内，我们将其限制在合理的值范围内：

     QLabel *fontSizeLabel = new QLabel(tr("Font size:"));
     QSpinBox *fontSizeSpinBox = new QSpinBox;
     fontSizeSpinBox->setRange(1, 64);

     editor = new QTextBrowser;
     insertCalendar();

  我们构造一个编辑器，并使用insertCalendar( )函数为其创建日历。 每个日历都显示在同一个文本编辑器中。 在此示例中，我们使用QTextBrowser，因为我们不允许编辑日历。
  除非我们进行一些信号槽连接，否则用于设置月，年和字体大小的控件将不会对日历的外观产生任何影响：

     connect(monthCombo, QOverload<int>::of(&QComboBox::activated),
             this, &MainWindow::setMonth);
     connect(yearEdit, &QDateTimeEdit::dateChanged,
             this, &MainWindow::setYear);
     connect(fontSizeSpinBox, QOverload<int>::of(&QSpinBox::valueChanged),
             this, &MainWindow::setFontSize);

信号连接到MainWindow类中的一些简单插槽，我们将在后面描述。
我们创建布局来管理我们构建的小部件：

     QHBoxLayout *controlsLayout = new QHBoxLayout;
     controlsLayout->addWidget(dateLabel);
     controlsLayout->addWidget(monthCombo);
     controlsLayout->addWidget(yearEdit);
     controlsLayout->addSpacing(24);
     controlsLayout->addWidget(fontSizeLabel);
     controlsLayout->addWidget(fontSizeSpinBox);
     controlsLayout->addStretch(1);

     QVBoxLayout *centralLayout = new QVBoxLayout;
     centralLayout->addLayout(controlsLayout);
     centralLayout->addWidget(editor, 1);
     centralWidget->setLayout(centralLayout);

     setCentralWidget(centralWidget);

  最后，为窗口设置中央窗口小部件。
  每个日历都是通过insertCalendar( )函数为编辑器创建的，该函数使用日期和字体大小（由私有selectedDate和fontSize变量定义）为指定的月份和年份生成合适的计划。

 void MainWindow::insertCalendar()
 {
     editor->clear();
     QTextCursor cursor = editor->textCursor();
     cursor.beginEditBlock();

     QDate date(selectedDate.year(), selectedDate.month(), 1);

  我们先清除编辑器的RTF文档，然后从编辑器中获取文本光标，以用于添加内容。 我们还根据当前选择的日期创建一个QDate对象。
日历由具有灰色背景颜色的表格组成，该表格包含七列：一周的每一天。 它放置在页面的中心，左右两边的距离相等。 所有这些属性都  在QTextTableFormat对象中设置：

     QTextTableFormat tableFormat;
     tableFormat.setAlignment(Qt::AlignHCenter);
     tableFormat.setBackground(QColor("#e0e0e0"));
     tableFormat.setCellPadding(2);
     tableFormat.setCellSpacing(4);

  表格中的每个单元格都会被填充和隔开，以使文本更易于阅读。
  我们希望这些列具有相等的宽度，因此我们提供一个包含每个列的百分比宽度的向量，并在QTextTableFormat中设置约束：

     QVector<QTextLength> constraints;
     constraints << QTextLength(QTextLength::PercentageLength, 14)
                 << QTextLength(QTextLength::PercentageLength, 14)
                 << QTextLength(QTextLength::PercentageLength, 14)
                 << QTextLength(QTextLength::PercentageLength, 14)
                 << QTextLength(QTextLength::PercentageLength, 14)
                 << QTextLength(QTextLength::PercentageLength, 14)
                 << QTextLength(QTextLength::PercentageLength, 14);
     tableFormat.setColumnWidthConstraints(constraints);

仅当表具有适当数量的列时，用于列宽的约束才有用。 定义了表的格式后，我们构造一个新表，在当前光标位置有一行七列：

     QTextTable *table = cursor.insertTable(1, 7, tableFormat);

我们只需要一行即可； 可以根据需要添加更多内容。 使用这种方法意味着在将单元格添加到表之前，我们不需要执行任何日期计算。
使用光标的插入功能将对象插入文档中时，光标会自动在新插入的对象内移动。 这意味着我们可以立即从内部开始修改表：

     QTextFrame *frame = cursor.currentFrame();
     QTextFrameFormat frameFormat = frame->frameFormat();
     frameFormat.setBorder(1);
     frame->setFrameFormat(frameFormat);

  由于表具有外部框架，因此我们获取框架及其格式，以便可以对其进行自定义。 进行所需的更改后，我们使用修改后的格式对象设置框架的格式。 我们为表格提供了一个像素宽的外部边界。

     QTextCharFormat format = cursor.charFormat();
     format.setFontPointSize(fontSize);

     QTextCharFormat boldFormat = format;
     boldFormat.setFontWeight(QFont::Bold);

     QTextCharFormat highlightedFormat = boldFormat;
     highlightedFormat.setBackground(Qt::yellow);

以类似的方式，我们获取光标的当前字符格式，并基于该格式创建自定义格式。
  我们不会在光标上设置格式，因为这会更改默认的字符格式。 而是在插入文本时显式使用自定义格式。 以下循环将星期几作为粗体插入表中：

     for (int weekDay = 1; weekDay <= 7; ++weekDay) {
         QTextTableCell cell = table->cellAt(0, weekDay-1);

  对于一周中的每一天，我们都使用表的cellAt( )函数在第一行（第0行）中获得一个现有的表单元格。 由于我们从第1天（星期一）开始计算星期几，因此我们从weekDay中减去1以确保获得表中正确列的单元格。
  在将文本插入单元格之前，我们必须获得一个在文档中具有正确位置的光标。 单元格为此提供了一个功能，我们使用此光标使用之前创建的boldFormat字符格式插入文本：

         QTextCursor cellCursor = cell.firstCursorPosition();
         cellCursor.insertText(QLocale::system().dayName(weekDay), boldFormat);
     }
     table->insertRows(table->rows(), 1);

  将文本插入文档对象通常遵循相同的模式。 每个对象都可以提供一个对应于其内部第一个有效位置的新光标，并且可以用来插入新内容。 当我们将月份中的天插入表中时，我们将继续使用此模式。
  由于每个月都有超过7天的时间，因此我们在一行中插入一行，然后添加几天，直到达到月底为止。 如果遇到当前日期，则会以一种特殊的格式（先前创建的）插入该格式，以使其突出显示：

    while (date.month() == selectedDate.month()) {
        int weekDay = date.dayOfWeek();
        QTextTableCell cell = table->cellAt(table->rows()-1, weekDay-1);
        QTextCursor cellCursor = cell.firstCursorPosition();

        if (date == QDate::currentDate())
            cellCursor.insertText(QString("%1").arg(date.day()), highlightedFormat);
        else
            cellCursor.insertText(QString("%1").arg(date.day()), format);

        date = date.addDays(1);
        // 仅当下周在当前所选月份之内时，我们才会在每个周末结束时在表中添加新行。
        if (weekDay == 7 && date.month() == selectedDate.month())
            table->insertRows(table->rows(), 1);
    }

    cursor.endEditBlock();

对于我们创建的每个日历，我们更改窗口标题以反映当前选定的月份和年份：

     setWindowTitle(tr("Calendar for %1 %2"
         ).arg(QLocale::system().monthName(selectedDate.month())
         ).arg(selectedDate.year()));
 }

insertCalendar( )函数依赖于月份，年份和字体大小的最新值。 这些设置在以下插槽中：

 void MainWindow::setFontSize(int size)
 {
     fontSize = size;
     insertCalendar();
 }

setFontSize( )函数仅在更新日历之前更改私有fontSize变量。

 void MainWindow::setMonth(int month)
 {
     selectedDate = QDate(selectedDate.year(), month + 1, selectedDate.day());
     insertCalendar();
 }

  当用于选择月份的QComboBox更新时，将调用setMonth插槽。 提供的值是组合框中当前选中的行。 我们在此值上加1以获取有效的月份号，然后根据现有的日期创建一个新的QDate。 然后，日历将更新为使用该新日期。

 void MainWindow::setYear(QDate date)
 {
     selectedDate = QDate(date.year(), selectedDate.month(), selectedDate.day());
     insertCalendar();
 }

  更新用于选择年份的QDateTimeEdit时，将调用setYear( )插槽。 提供的值是QDate对象； 这使selectedDate的新值的构造变得简单。 之后，我们将更新日历以使用这个新日期。

总结

可以利用文本光标，获取所在单元格的文本块格式，然后设置文本块的居中对齐模式，看上去更舒服点。

        QTextBlockFormat cellBlockFormat = cellCursor.blockFormat();
        cellBlockFormat.setAlignment(Qt::AlignCenter);
        cellCursor.setBlockFormat(cellBlockFormat);