QT教程-十七,QTextBrowser

  QTextBrowser 是 Qt 框架中的一个小部件，继承自 QTextEdit，用于显示和编辑富文本（包括 HTML 格式）。它提供了更多的功能，比如支持超链接、内嵌图片、和简单的格式化文本。

一，常用功能和属性

1. 显示 HTML 内容：

   • 你可以使用 setHtml() 方法来设置 HTML 格式的文本内容。
   • 例如：textBrowser->setHtml("<h1>标题</h1><p>这是一个段落。</p>");

2. 显示纯文本：

   • 你可以使用 setPlainText() 方法来设置纯文本内容。
   • 例如：textBrowser->setPlainText("这是纯文本。");

3. 处理超链接：

   • QTextBrowser 会自动处理 HTML 超链接。你可以使用 setOpenExternalLinks(true) 方法来让超链接在外部浏览器中打开。
   • 例如：textBrowser->setOpenExternalLinks(true);

4. 设置文本样式：

   • 可以使用 HTML 标签来设置文本的样式。比如：<b>加粗文本</b> 或 <i>斜体文本</i>。

5. 嵌入图片：

   • 可以在 HTML 内容中使用 <img> 标签嵌入图片。确保图片路径正确或者使用完整的 URL。

6. 实现自定义点击行为：

   • 你可以重写 QTextBrowser 的 anchorClicked 信号来实现自定义点击行为。
   • 例如：

     connect(textBrowser, &QTextBrowser::anchorClicked, this, [](const QUrl &url){
         qDebug() << "Clicked URL:" << url.toString();
     });
     

二，示例代码

下面是一个简单的例子，展示了如何使用 QTextBrowser：

#include <QApplication>
#include <QWidget>
#include <QTextBrowser>
#include <QVBoxLayout>

class MyWidget : public QWidget
{
public:
    MyWidget()
    {
        // 创建 QTextBrowser 对象
        QTextBrowser *textBrowser = new QTextBrowser;

        // 设置 HTML 内容
        textBrowser->setHtml("<h1>这是 QTextBrowser</h1>"
                              "<p>这是一个带有 <a href='https://www.example.com'>超链接</a> 的文本示例。</p>"
                              "<p>下面是一张图片：</p>"
                              "<img src='https://www.example.com/image.jpg' width='200'>");

        // 设置外部链接在浏览器中打开
        textBrowser->setOpenExternalLinks(true);

        // 布局设置
        QVBoxLayout *layout = new QVBoxLayout;
        layout->addWidget(textBrowser);
        setLayout(layout);

        // 设置窗口标题和大小
        setWindowTitle("QTextBrowser 示例");
        resize(400, 300);
    }
};

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    MyWidget widget;
    widget.show();

    return app.exec();
}

在这个例子中：

    创建了一个 QTextBrowser 对象，并设置了带有 HTML 内容的文本。

    使用 setOpenExternalLinks(true) 使超链接在外部浏览器中打开。

    将 QTextBrowser 添加到布局中，并设置了窗口的标题和大小。

三，自定义

1. 自定义链接处理：

   • 如果你想在点击链接时执行自定义操作，可以使用 anchorClicked 信号。以下是如何实现这一点：

     connect(textBrowser, &QTextBrowser::anchorClicked, [](const QUrl &url){
         // 自定义点击链接的行为
         qDebug() << "Clicked URL:" << url.toString();
         // 可以在这里打开链接或者执行其他操作
     });
     

2. 加载外部 HTML 文件：

   • 如果你有外部的 HTML 文件，可以使用 setSource() 方法加载：

     textBrowser->setSource(QUrl::fromLocalFile("/path/to/your/file.html"));
     

3. 修改字体和样式：

   • 你可以通过 HTML 标签自定义字体和样式。例如：

     textBrowser->setHtml("<p style='font-size:20px; color:red;'>这是大号红色文本。</p>");
     

4. 启用或禁用编辑功能：

   • 默认情况下，QTextBrowser 是只读的。如果你需要使它可编辑，可以继承 QTextBrowser 并重写 canInsertFromMimeData() 方法来允许或禁止插入内容。