QTextBrowser使用append时自动识别成HTML文本的问题

最新推荐文章于 2025-06-26 21:40:22 发布

原创最新推荐文章于 2025-06-26 21:40:22 发布 · 1.2k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#前端

Qt 专栏收录该内容

19 篇文章

订阅专栏

在Qt编程中，当尝试将XML文本分段显示在QTextBrowser时，遇到问题：从某一行开始的数据被误识别为HTML，导致部分数据无法正常显示。通过查看QT源码，发现在QWidgetTextControl::append函数中，默认使用Qt::AutoText导致此问题。为解决此问题，可以改用QTextEdit::insertPlainText或QTextEdit::insertHtml，确保正确插入文本。对于纯文本，使用insertPlainText，对于HTML格式，则使用insertHtml，并确保数据格式正确。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

如下图，我在将一个XML文本展示在QTextBrowser时，分段进行读取并展示。从42行开始时刚好为新的一段数据，将这段数据append进QTextBrowser时，出现了图2的问题，QT内部自动将这段数据识别成HTML文本，导致部分数据消失。
在这里插入图片描述

查看QT助手，QTextBrowser的append继承至QTextEdit；
继续查看QT源码，如下：

QWidgetTextControl *control;

void QTextEdit::append(const QString &text)
{
    Q_D(QTextEdit);
    const bool atBottom = isReadOnly() ?  d->verticalOffset() >= d->vbar->maximum() :
            d->control->textCursor().atEnd();
    d->control->append(text);
    if (atBottom)
        d->vbar->setValue(d->vbar->maximum());
}

查看QWidgetTextControl文件：

void QWidgetTextControl::append(const QString &text)
{
    Q_D(QWidgetTextControl);
    d->append(text, Qt::AutoText);//在这里默认设置了参数Qt::AutoText，实际上我想使用Qt::PlainText
}

void QWidgetTextControlPrivate::append(const QString &text, Qt::TextFormat format)
{
    QTextCursor tmp(doc);
    tmp.beginEditBlock();
    tmp.movePosition(QTextCursor::End);

    if (!doc->isEmpty())
        tmp.insertBlock(cursor.blockFormat(), cursor.charFormat());
    else
        tmp.setCharFormat(cursor.charFormat());

    // preserve the char format
    QTextCharFormat oldCharFormat = cursor.charFormat();

#ifndef QT_NO_TEXTHTMLPARSER
    if (format == Qt::RichText || (format == Qt::AutoText && Qt::mightBeRichText(text))) {
        tmp.insertHtml(text);
    } else {
        tmp.insertText(text);
    }
#else
    Q_UNUSED(format);
    tmp.insertText(text);
#endif // QT_NO_TEXTHTMLPARSER
    if (!cursor.hasSelection())
        cursor.setCharFormat(oldCharFormat);

    tmp.endEditBlock();
}

经过测试发现，QWidgetTextControlPrivate::append中将这段数据识别成了HTML文本，自动调用了QTextCursor::insertHtml函数。
因为QWidgetTextControl::append中默认调用了append(text, Qt::AutoText);

继续看QTextEdit::insertPlainText函数：

void QTextEdit::insertPlainText(const QString &text)
{
    Q_D(QTextEdit);
    d->control->insertPlainText(text);
}

void QWidgetTextControl::insertPlainText(const QString &text)
{
    Q_D(QWidgetTextControl);
    d->cursor.insertText(text);
}

发现，调用QTextEdit::insertPlainText，实际上程序内部调用更加简单，而且能直接调用QTextCursor::insertText函数。
如果确认自己插入的数据是HTML文本，也可以直接调用QTextEdit::insertHtml：

#ifndef QT_NO_TEXTHTMLPARSER
void QTextEdit::insertHtml(const QString &text)
{
    Q_D(QTextEdit);
    d->control->insertHtml(text);
}
#endif // QT_NO_TEXTHTMLPARSER

当然，使用insert时，最好确认光标不会被移动，否则就不知道插入到哪个位置了！

最后贴一下Qt::mightBeRichText的解释

bool Qt::mightBeRichText(const QString &text)
Returns true if the string text is likely to be rich text; otherwise returns false.
This function uses a fast and therefore simple heuristic. It mainly checks whether there is something that looks like a tag before the first line break. Although the result may be correct for common cases, there is no guarantee.
This function is defined in the <QTextDocument> header file.