Qt 富文本处理（05）：常见的富文本编辑任务【来自官档的翻译】

最新推荐文章于 2023-11-22 22:56:10 发布

原创最新推荐文章于 2023-11-22 22:56:10 发布 · 716 阅读

1 ·

CC 4.0 BY-SA版权

Qt 富文本处理专栏收录该内容

19 篇文章

订阅专栏

前言

官方文档 Rich Text Processing - Common Rich Text Editing Tasks

在使用 Qt 编辑和处理文本文档时，开发人员通常会执行许多任务。其中包括使用显示小部件，如QTextBrowser和QTextEdit，创建具有QTextDocument的文档，使用QTextCursor编辑，以及导出文档结构。本文档概述了使用富文本类执行这些任务的一些更常见方法，显示了可以在您自己的应用程序中重用的方便模式。

使用 QTextEdit

可以构造文本编辑器小部件，并用于以下列方式显示 HTML：

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

默认情况下，文本编辑器包含具有根框架的文档，其中是一个空文本块。可以获取此文档，以便应用程序可以直接修改它：

QTextDocument *document = editor->document();

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

QTextCursor cursor = editor->textCursor();

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

editor->setTextCursor(cursor);

选择文本

通过使用与文本编辑器中用户执行的操作类似的操作移动光标来选择文本。若要在文档中的两个点之间选择文本，我们需要将光标定位在第一个点，然后使用特殊模式（QTextCursor：：移动模式）使用移动操作（QTextCursor：：移动操作）移动光标。选择文本时，我们将选择锚点留在旧光标位置，就像用户在选择文本时按住 Shift 键时一样：

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

在上面的代码中，使用此方法选择整个单词。QTextCursor提供了许多用于选择单个字符、单词、行和整个块的常见移动操作。

查找文本

QTextDocument提供了一个基于游标的搜索界面，便于查找和修改文本编辑器样式的文本。以下代码查找文档中特定单词的所有实例，并更改每个单词的颜色：

    QTextCursor newCursor(document);

    while (!newCursor.isNull() && !newCursor.atEnd()) {
        newCursor = document->find(searchString, newCursor);

        if (!newCursor.isNull()) {
            newCursor.movePosition(QTextCursor::WordRight,
                                   QTextCursor::KeepAnchor);

            newCursor.mergeCharFormat(colorFormat);
        }
    }

请注意，每次搜索和替换操作后，不必移动光标;它总是位于刚刚替换的单词的末尾。

打印文档

QTextEdit设计用于显示在屏幕上读取的大型富文本文档，以与 Web 浏览器相同的方式呈现它们。因此，它不会自动将文档的内容分解为适合打印的页面大小。

QTextDocument提供打印函数，允许使用 QPrinter 类打印文档。以下代码演示如何在 QTextEdit 中准备文档，以便使用 QPrinter 进行打印：

    QTextDocument *document = editor->document();
    QPrinter printer;

    QPrintDialog *dlg = new QPrintDialog(&printer, this);
    if (dlg->exec() != QDialog::Accepted)
        return;

    document->print(&printer);

文档是从文本编辑器获取的，然后使用 QPrintDialog 构造 QPrinter。如果用户接受打印机的配置，则使用 print（）功能对文档进行格式化和打印。