【QT】`QTextCursor::insertText()`中插入彩色文本

在 Qt 的 QTextEdit 中，QTextCursor::insertText() 默认只能插入纯文本。要插入彩色文本，需要配合使用 QTextCharFormat 来设置文本格式。以下是几种实现彩色文本插入的方法：

方法 1：使用 QTextCharFormat 设置文本颜色

// 创建文本格式对象
QTextCharFormat format;
format.setForeground(QBrush(Qt::red));  // 设置文本颜色为红色

// 获取光标并插入带格式的文本
QTextCursor cursor = ui->textEdit->textCursor();
cursor.insertText("这是红色文本", format);  // 插入彩色文本

// 继续插入默认颜色的文本
cursor.insertText(" 这是默认颜色文本");

方法 2：修改当前光标的字符格式

QTextCursor cursor = ui->textEdit->textCursor();

// 保存当前格式
QTextCharFormat originalFormat = cursor.charFormat();

// 创建新格式
QTextCharFormat colorFormat;
colorFormat.setForeground(Qt::blue);

// 应用新格式
cursor.setCharFormat(colorFormat);
cursor.insertText("蓝色文本");

// 恢复原始格式
cursor.setCharFormat(originalFormat);
cursor.insertText(" 默认颜色文本");

方法 3：使用 HTML 格式插入彩色文本

// 直接插入 HTML
ui->textEdit->append("<span style='color:green;'>绿色文本</span>");

// 或在光标位置插入
QTextCursor cursor = ui->textEdit->textCursor();
cursor.insertHtml("<span style='color:#FF8800;'>橙色文本</span>");

方法 4：创建带格式的文本片段（更高级用法）

// 创建文档片段
QTextDocumentFragment fragment = QTextDocumentFragment::fromHtml(
    "<span style='color:purple; font-weight:bold;'>紫色粗体文本</span>"
);

// 插入片段
QTextCursor cursor = ui->textEdit->textCursor();
cursor.insertFragment(fragment);

注意事项：

1. 格式作用范围：

   • 设置字符格式后，后续插入的文本会保持该格式，直到显式更改格式
   • 使用 setCharFormat() 会改变光标位置的格式状态

2. HTML 限制：

   • insertHtml() 不支持完整的 HTML/CSS，只支持 Qt 的富文本子集
   • 复杂的 HTML 结构可能无法正确解析

3. 性能考虑：

   • 对于大量文本，直接操作格式比插入 HTML 更高效
   • 频繁切换格式会影响性能

完整示例：在 QTextEdit 中显示多色文本

void addColoredText(QTextEdit* textEdit, const QString& text, const QColor& color) {
    QTextCursor cursor(textEdit->textCursor());
    cursor.movePosition(QTextCursor::End);
    
    QTextCharFormat format;
    format.setForeground(color);
    cursor.insertText(text, format);
}

// 使用示例
addColoredText(ui->textEdit, "错误: ", Qt::red);
addColoredText(ui->textEdit, "文件未找到\n", Qt::black);
addColoredText(ui->textEdit, "警告: ", Qt::darkYellow);
addColoredText(ui->textEdit, "内存使用过高\n", Qt::black);

替代方案：使用 QSyntaxHighlighter

如果需要实现语法高亮（如代码编辑器），更好的选择是继承 QSyntaxHighlighter：

class Highlighter : public QSyntaxHighlighter {
public:
    Highlighter(QTextDocument* parent) : QSyntaxHighlighter(parent) {}
    
protected:
    void highlightBlock(const QString& text) override {
        // 设置错误文本格式
        QTextCharFormat errorFormat;
        errorFormat.setForeground(Qt::red);
        
        // 匹配错误模式
        QRegularExpression regex("\\bERROR\\b");
        QRegularExpressionMatchIterator it = regex.globalMatch(text);
        while (it.hasNext()) {
            QRegularExpressionMatch match = it.next();
            setFormat(match.capturedStart(), match.capturedLength(), errorFormat);
        }
    }
};

// 使用
Highlighter* highlighter = new Highlighter(ui->textEdit->document());

总结：虽然 insertText() 本身不能直接插入彩色文本，但配合 QTextCharFormat 或 HTML 方法可以轻松实现彩色文本显示。根据需求选择合适的方法：

• 简单颜色变化：使用 QTextCharFormat
• 复杂格式：使用 HTML
• 语法高亮：使用 QSyntaxHighlighter