【Qt笔记】QTextEdit和QPlainTextEdit 控件详解

在图形用户界面（GUI）设计领域中，文本编辑控件是不可或缺的元素之一，它们为用户提供了输入、编辑和显示文本内容的平台。在Qt中，QTextEdit和QPlainTextEdit作为Qt框架中两个重要的文本编辑控件，各自拥有独特的特点和适用场景。本文旨在深入解析QTextEdit与QPlainTextEdit的功能、用法及其区别，帮助开发者根据实际需求选择最合适的控件来优化用户体验和应用程序性能。无论是需要支持富文本格式（如HTML、样式化文本）的场景，还是追求高效纯文本编辑的场合，通过本文的详细阐述，您都将获得全面的指导和实践建议。让我们一同探索这两个控件的奥秘，为您的Qt应用程序增添更加丰富的文本处理能力。

一、QTextEdit 控件

1.1 概述

QTextEdit 是 Qt 提供的一个功能强大的富文本编辑控件，它允许用户输入和编辑包含多种格式的文本，如字体、字号、颜色、段落样式、列表、图片等。它基于 QAbstractScrollArea 类，具备自动换行、滚动条等基本功能，适用于需要复杂文本排版的场景，比如撰写文档、邮件客户端的邮件正文编辑等。

1.2 主要特性

1.2.1 富文本格式支持

用户可以通过工具栏按钮、快捷键（类似于常见的文字处理软件）或编程方式设置文本的字体特性，如 QFont 类可以指定字体家族（如 Arial、Times New Roman 等）、字号（如 12pt、16pt 等）、加粗、倾斜、下划线等样式。例如：

QTextEdit *textEdit = new QTextEdit(this);
QTextCursor cursor = textEdit->textCursor();
QFont font;
font.setFamily("Arial"); // 设置字体样式
font.setPointSize(14); // 设置字体大小
font.setBold(true); // 设置字体为粗体
cursor.setCharFormat(QTextCharFormat().setFont(font));
textEdit->setTextCursor(cursor);

1.2.2 文本颜色

文本颜色可以使用 QColor 类来设置，支持常见的颜色表示方式，如 RGB 值、颜色名称等。同样通过 QTextCharFormat 来应用到文本片段上：

QColor redColor(255, 0, 0);
QTextCharFormat format;
format.setForeground(redColor);
cursor.setCharFormat(format);

1.2.3 段落格式

段落格式的对齐对于文档排版至关重要，QTextEdit 借助 QTextBlockFormat 类轻松实现多种对齐方式。

#include <QTextEdit>
#include <QTextCursor>
#include <QTextBlockFormat>

QTextEdit* textEdit = new QTextEdit(this);
QTextCursor cursor = textEdit->textCursor();

// 居中对齐段落
QTextBlockFormat blockFormat;
blockFormat.setAlignment(Qt::AlignCenter);
cursor.mergeBlockFormat(blockFormat);

textEdit->setTextCursor(cursor);

这里创建 QTextBlockFormat 并指定对齐方式为居中对齐 Qt::AlignCenter，再通过光标将此格式应用到段落，实现段落文本在 QTextEdit 控件中的居中显示。同样，还可将对齐方式设置为 Qt::AlignLeft（左对齐）、Qt::AlignRight（右对齐）、Qt::AlignJustify（两端对齐）以满足不同排版要求。

除了段落对齐方式之外，段落缩进、悬挂缩进等格式设置也可以精确控制，满足不同的排版需求，这对于文档排版非常关键，能使文本结构清晰。以下是一个设置缩进的样例：

// 设置段落首行缩进
blockFormat.setTextIndent(20);
// 设置悬挂缩进
blockFormat.setIndent(30);
cursor.mergeBlockFormat(blockFormat);

1.2.4 列表支持

QTextEdit 提供便捷的列表创建功能，包括有序列表和无序列表，利用 QTextListFormat 来定义列表样式。

有序列表：

#include <QTextEdit>
#include <QTextCursor>
#include <QTextListFormat>

QTextEdit* textEdit = new QTextEdit(this);
QTextCursor cursor = textEdit->textCursor();

QTextListFormat listFormat;
listFormat.setStyle(QTextListFormat::ListDecimal);
cursor.insertList(listFormat);

textEdit

最低0.47元/天解锁文章