qt QTextFrame详解

1. 概述

QTextFrame是Qt框架中用于表示文本框架的类。它允许在QTextDocument中创建和管理具有特定边界和格式的文本区域。QTextFrame可以包含文本、图像、表格或其他QTextFrame，从而提供丰富的文本布局和排版功能。QTextFrame通常与QTextCursor结合使用，以便在富文本编辑器中插入、编辑和删除框架内容。

2. 重要方法

QTextFrame类的重要方法包括：

构造函数：QTextFrame() - 创建一个空的QTextFrame对象。注意，通常不会直接创建QTextFrame对象，而是通过QTextCursor的insertFrame()方法或QTextDocument的布局机制来间接创建。
frameFormat()：QTextFrameFormat frameFormat() const - 返回框架的格式，包括边界、边距、填充等。
setFrameFormat()：void setFrameFormat(const QTextFrameFormat &format) - 设置框架的格式。
firstCursorPosition()：QTextCursor firstCursorPosition() const - 返回指向框架内第一个字符的QTextCursor对象。
lastCursorPosition()：QTextCursor lastCursorPosition() const - 返回指向框架内最后一个字符的QTextCursor对象。
parentFrame()：QTextFrame *parentFrame() const - 返回包含此框架的父框架，如果没有父框架则返回nullptr。

childFrames()：QList<QTextFrame *> childFrames() const - 返回此框架包含的所有子框架的列表。

#include <QCoreApplication>
#include <QTextDocument>
#include <QTextCursor>
#include <QTextFrame>
#include <QTextFrameFormat>
#include <QTextBlockFormat>
#include <QDebug>

int main(int argc, char *argv[]) {
QCoreApplication a(argc, argv);

  QTextDocument doc;
  QTextCursor cursor(&doc);

  // 插入一些初始文本
  cursor.insertText("This is some initial text outside the frame.\n");

  // 创建一个文本框架
  QTextFrameFormat frameFormat;
  frameFormat.setBorder(2); // 设置边框宽度
  frameFormat.setBorderBrush(QBrush(Qt::black)); // 设置边框颜色
  frameFormat.setPadding(10); // 设置内边距
  frameFormat.setMargin(20); // 设置外边距

  QTextFrame *frame = cursor.insertFrame(frameFormat);

  // 在框架内插入文本
  QTextCursor frameCursor(frame);
  frameCursor.insertText("This is text inside the frame.\n");
  frameCursor.insertText("More text inside the frame.\n");

  // 遍历框架并打印每个块的内容（在这个例子中，框架内有两个块）
  QTextCursor reader(frame);
  reader.movePosition(QTextCursor::Start);
  while (!reader.atEnd()) {
      QTextBlock block = reader.block();
      qDebug() << block.text();
      reader.movePosition(QTextCursor::NextBlock);
  }

  // 打印整个文档的内容（包括框架外的文本和框架内的文本）
  QTextCursor docReader(&doc);
  docReader.movePosition(QTextCursor::Start);
  while (!docReader.atEnd()) {
      QTextBlock block = docReader.block();
      qDebug() << block.text();
      docReader.movePosition(QTextCursor::NextBlock);
  }

  return a.exec();

}

觉得有帮助的话，打赏一下呗。。