按顺序遍历文本块：

    QTextBlock currentBlock = docment->begin();while (currentBlock.isValid()) {//...currentBlock = currentBlock.next();}

1.2.2、框架

文本框架将文本块和子框架组合在一起，创建大于段落范围的文档结构。

每个框架含至少一个文本块和大于等于零个子框架。

每个文档都有一个包含所有其他文档元素的根框架。因此，除根框架外的所有框架都具有父框架。

可使用 QTextFrame::iterator 遍历框架的子元素：

    QTextDocument * docment = ui->textEdit->document();QTextFrame * rootFrame = docment->rootFrame();for (QTextFrame::iterator it = rootFrame->begin(); !(it.atEnd()); ++it){QTextFrame *childFrame = it.currentFrame();QTextBlock childBlock = it.currentBlock();if (childFrame){//...}else if (childBlock.isValid()){//...}}

1.2.3、表格

表格是按行和列排列的单元格集合。每个单元格都是一个具有字符格式的文档元素，但它也可以包含其他元素，如框架和文本块。

QTextTable 是 QTextFrame 的子类，因此表格在文档结构中被视为框架。

对于文档中遇到的每个框架，可以测试它是否表示一个表格，并以不同的方式处理它： 

    QTextDocument * docment = ui->textEdit->document();QTextFrame * rootFrame = docment->rootFrame();for (QTextFrame::iterator it = rootFrame->begin(); !(it.atEnd()); ++it){QTextFrame *childFrame = it.currentFrame();QTextBlock childBlock = it.currentBlock();if (childFrame){if (QTextTable *childTable = qobject_cast(childFrame)){//...}else{//...}}else if (childBlock.isValid()){//...}}

可以通过遍历行和列来检查现有表中的单元格。

    for (int row = 0; row < table->rows(); ++row) {for (int column = 0; column < table->columns(); ++column) {QTextTableCell tableCell = table->cellAt(row, column);//...}}

 1.2.4、列表

列表通常以格式化方式展示文本块序列。

列表可以嵌套和设置缩进。

可以通过列表中的索引来引用每个列表项：

    QTextDocument * docment = ui->textEdit->document();QTextBlock block = docment->findBlock(0);   if (QTextList * list = block.textList()) {for (int index = 0; index < list->count(); ++index) {QTextBlock listItem = list->item(index);//...}}

QTextList 是 QTextBlockGroup（可管理文本块分组） 的子类，QTextList 仅为它的列表项提供管理功能，而没有把列表项作为它的子项。 

即在遍历文档时发现的任何文本块实际上都可能是列表项。可以通过以下代码确保正确识别列表项： 

    QTextDocument * docment = ui->textEdit->document();QTextFrame * rootFrame = docment->rootFrame();for (QTextFrame::iterator it = rootFrame->begin(); !(it.atEnd()); ++it){QTextBlock block = it.currentBlock();if (block.isValid()) {if (QTextList *list = block.textList()) {int index = list->itemNumber(block);//processListItem(list, index);}}}

二、QTextCursor 接口

2.1、基于光标的文本编辑

QTextCursor 提供了一个基于光标的编辑方式，允许在字符级别操纵 QTextDocument 的内容。

光标会跟踪其在父文档中的位置，并可以报告有关周围结构的信息，例如包围的文本块、框架、表格或列表。

2.1.1、分组光标操作

一系列编辑操作可以打包在一起，以便可以在一个动作中一起回放或撤消。选择包含光标的内容：

    cursor.beginEditBlock();cursor.movePosition(QTextCursor::StartOfWord);cursor.movePosition(QTextCursor::EndOfWord, QTextCursor::KeepAnchor);cursor.endEditBlock();

如果编辑操作未分组，文档将自动记录各个操作，以便以后可以撤消这些操作。

2.1.2、多个光标

可以使用多个光标同时编辑同一个文档，尽管用户在编辑小部件中只能看到一个光标。

QTextDocument 确保每个光标正确写入文本，并且不会干扰其他光标。

三、文档布局

文档的布局仅在要在设备上显示时相关。

每个文档的布局都由 QAbstractTextDocumentLayout 类的子类管理。

QTextLayout 用法示例：

#include "widget.h"
#include 
#include Widget::Widget(QWidget *parent): QWidget(parent)
{auto font = this->font();font.setPixelSize(18);setFont(font);
}Widget::~Widget()
{
}void Widget::paintEvent(QPaintEvent *event)
{auto rect = event->rect();QTextLayout textLayout("黄河之水天上来，奔流到海不复回", this->font());qreal margin = 40;qreal radius = qMin(rect.width()/2.0, rect.height()/2.0) - margin;QPainter painter(this);painter.setRenderHint(QPainter::Antialiasing);painter.fillRect(rect, Qt::white);painter.setBrush(QBrush(Qt::black));painter.setPen(QPen(Qt::black));painter.setBrush(QBrush(QColor("#a6ce39")));painter.setPen(QPen(Qt::black));painter.translate(rect.center());painter.drawEllipse(QPointF(0,0),radius,radius);painter.setPen(QPen(Qt::red,5));for(int i = 0;i < 14;++i){auto angle = 25.0 * i;auto x = cos(qDegreesToRadians(angle)) * (radius + 20);auto y = -sin(qDegreesToRadians(angle)) * (radius + 20);painter.drawPoint(x,y);}textLayout.beginLayout();auto angle{0.0f};while (true){QTextLine line = textLayout.createLine();if (!line.isValid())break;auto x = cos(qDegreesToRadians(angle)) * (radius + 20);auto y = -sin(qDegreesToRadians(angle)) * (radius + 20);line.setLineWidth(20);line.setPosition(QPointF(x,y));angle += 25;}textLayout.endLayout();textLayout.draw(&painter, QPoint(0,0));
}

四、常见富文本编辑操作

4.1、使用 QTextEdit

QTextEdit 可以通过以下方式构造并用于显示HTML：

QTextEdit *editor = new QTextEdit(parent);
editor->setHtml(aStringContainingHTMLtext);
editor->show();

默认 QTextEdit 包含一个带有根框架的文档，其中包含一个空文本块。可以获取此文档：

QTextDocument *document = editor->document();

QTextEdit 的光标也可用于编辑文档：

QTextCursor cursor = editor->textCursor();

虽然可以同时使用多个光标编辑文档，但 QTextEdit 一次只显示一个光标。因此，如果想更新编辑器以显示特定的光标或其选择，则需要在修改文档后设置编辑器的光标：

editor->setTextCursor(cursor);

4.2、选择文本

要在文档中的两个点之间选择文本，需要将光标定位在第一个点，然后设置移动模式（QTextCursor::MoveMode）和移动操作（QTextCursor::MoveOperation）移动它。

选择文本时，选择的锚点保留在原来的光标位置：

    cursor.movePosition(QTextCursor::StartOfWord);cursor.movePosition(QTextCursor::EndOfWord, QTextCursor::KeepAnchor);

4.3、查找文本

QTextDocument 提供了基于光标的搜索功能。

查找文档中所有的特定单词，并更改它们的颜色：

    auto document = ui->textEdit->document();auto searchString{"hello"};QTextCharFormat colorFormat;colorFormat.setBackground(Qt::cyan);QTextCursor newCursor(document);while (!newCursor.isNull() && !newCursor.atEnd()){newCursor = document->find(searchString, newCursor);if (!newCursor.isNull()){newCursor.movePosition(QTextCursor::NoMove,QTextCursor::KeepAnchor);newCursor.mergeCharFormat(colorFormat);}}

在每次搜索和替换操作后，不必移动光标，它总是位于搜索和被替换的词的末尾。

五、对HTML的支持

5.1、支持的标记

Qt富文本引擎支持的HTML标记：

5.2、CSS属性

使用css属性示例：

    ui->textEdit->setHtml(R"(


我是h1
我是h2

)");

Qt富文本引擎支持的CSS属性：

5.3、Qt特定的CSS属性

可以使用以下Qt特定属性来设置文本块的样式：

• -qt-block-indent（数值）：按指定的数字空格缩进文本块。

测试发现设置为1会缩进半个制表符的空间。

• -qt-listindent：按指定的空格数缩进列表项。

• -qt-list-number-prefix
• -qt-list-number-suffix
• -qt-paragraph-type
• -qt-table-type
• -qt-user-state