Qt中如何创建可完整展示长文本信息的外部信息窗口

QMessageBox::about 本身是为短文本提示场景设计的，没有做长文本适配：它内部承载文本的是普通QLabel，没有内置滚动区域，文本长度超出展示范围时会强制拉伸窗口直到超出屏幕边界，自带的自动折行逻辑还会打乱手动写的排版格式，完全不适合承载长篇格式说明内容。

最贴合预期效果的实现方式非常简单：自定义轻量QDialog，内部放置只读QTextEdit承载文本，自带滚动条、支持固定窗口大小、排版完全可控，后续追加说明内容也不会出现显示异常。

可直接复用的实现代码 #

#include <QDialog>
#include <QTextEdit>
#include <QVBoxLayout>
#include <QDialogButtonBox>

void MainWindow::on_actionAcerca_del_programa_triggered()
{
    // 构建说明文本，原有内容无需大幅调整
    QString txt;
    txt = "<h3>Declaracion de los elementos, formato de escritura</h3><pre>"; // pre标签保留原始换行、空格格式，避免自动折行乱版

    txt += "Fuente de voltaje independiente DC: (Vnombre) (nodo 1) (nodo 2) (Tipo de fuente) (amplitud)\n";
    txt += "Ejemplo: v1 1 2 DC 5\n\n";

    txt += "Fuente de corriente independiente DC: (Inombre) (nodo 1) (nodo 2) (Tipo de fuente) (amplitud)\n";
    txt += "Ejemplo: i1 1 2 DC 5\n\n";

    txt += "Resistencia: (Rnombre) (nodo 1) (nodo 2) (valor)\n";
    txt += "Ejemplo: R1 1 2 1000\n\n";

    txt += "Capacitores (condiciones iniciales igual a 0): (Cnombre) (nodo 1) (nodo 2) (valor)\n";
    txt += "Ejemplo: C1 1 2 1000\n\n";

    txt += "Capacitores (condiciones  distintas de 0): (Cnombre) (nodo 1) (nodo 2) (valor) (ic=valor)\n";
    txt += "Ejemplo: C1 1 2 1 ic=0.6\n\n";

    txt += "Inductores (condiciones iniciales igual a 0): (Lnombre) (nodo 1) (nodo 2) (valor)\n";
    txt += "Ejemplo: L1 1 2 1000\n\n";

    txt += "Inductores (condiciones  distintas de 0): (Lnombre) (nodo 1) (nodo 2) (valor) (ic=valor)\n";
    txt += "Ejemplo: L1 1 2 1 ic=0.6\n\n";

    txt += "Fuentes de corriente controladas por voltaje: (Gnombre) (nodo 1) (nodo 2) (nodo3) (nodo4) (valor)\n";
    txt += "Ejemplo: G1 1 2 3 4 10\n\n";

    txt += "Fuentes de corriente controladas por corriente: (Fnombre) (nodo 1) (nodo 2) (nodo3) (nodo4) (valor)\n";
    txt += "Ejemplo: F1 1 2 3 4 10\n\n";

    txt += "Fuentes de voltaje controladas por voltaje: (Enombre) (nodo 1) (nodo 2) (nodo3) (nodo4) (valor)\n";
    txt += "Ejemplo: E1 1 2 3 4 10\n\n";

    txt += "Fuentes de voltaje controladas por corriente: (Hnombre) (nodo 1) (nodo 2) (nodo3) (nodo4) (valor)\n";
    txt += "Ejemplo: G1 1 2 3 4 10\n\n";

    txt += "Transformadores ideales: (Nnombre) (nodo 1) (nodo 2) (nodo3) (nodo4) (valor)\n";
    txt += "Ejemplo: N1 1 2 3 4 12\n\n";

    txt += "Amplificadores operacionales: (Onombre) (nodo 1) (nodo 2) (salida) (valor)\n";
    txt += "Ejemplo: O1 1 2 3 4 12\n\n";
    txt += "</pre>";

    // 创建对话框
    QDialog* infoDlg = new QDialog(this);
    infoDlg->setWindowTitle("AnSiRE");
    infoDlg->setAttribute(Qt::WA_DeleteOnClose); // 窗口关闭后自动释放内存
    infoDlg->resize(600, 500); // 固定初始窗口尺寸，不会被内容撑到超出屏幕

    QVBoxLayout* layout = new QVBoxLayout(infoDlg);
    // 文本展示控件
    QTextEdit* textView = new QTextEdit(infoDlg);
    textView->setReadOnly(true); // 设置为只读模式，禁止用户编辑
    textView->setHtml(txt); // 加载富文本内容
    layout->addWidget(textView);
    // 底部确认按钮
    QDialogButtonBox* btnBox = new QDialogButtonBox(QDialogButtonBox::Ok, infoDlg);
    connect(btnBox, &QDialogButtonBox::accepted, infoDlg, &QDialog::accept);
    layout->addWidget(btnBox);

    infoDlg->exec();
}

实现说明 #

• 用<pre>标签包裹格式内容，会完全保留手动写的换行、空格对齐，不会出现自动折行打乱格式的问题
• QTextEdit自带垂直、水平滚动条，内容再多也不会撑大窗口超出屏幕
• 如果后续需要给内容加高亮、分节标题，直接在文本里添加简单HTML标签即可，比纯文本展示灵活度高很多
• 所有用到的类都属于Qt基础模块，不需要额外引入第三方组件，兼容所有Qt5、Qt6版本

避坑提示 #

不建议通过遍历QMessageBox内部子控件、手动给QLabel套QScrollArea的方式修改QMessageBox实现长文本展示，这种方案依赖QMessageBox的内部布局结构，不同Qt版本的内部实现有差异，代码兼容性极差，远不如自定义对话框稳定。

内容的提问来源于stack exchange，提问作者Xavier