Qt应用开发(基础篇)——富文本浏览器 QTextBrowser

一、前言

        QTextBrowser类继承于QTextEdit，是一个具有超文本导航的富文本浏览器。 

框架类 QFramehttps://blog.csdn.net/u014491932/article/details/132188655  滚屏区域基类 QAbstractScrollAreahttps://blog.csdn.net/u014491932/article/details/132245486  文本编辑窗口QTextEdithttps://blog.csdn.net/u014491932/article/details/132401318?spm=1001.2014.3001.5501

         QTextBrowser类扩展了QTextEdit，添加了一些导航功能，以便用户可以跟踪超文本文档中的链接。如果您想为用户提供一个可编辑的富文本编辑器，请使用QTextEdit。如果你想要一个没有超文本导航的文本浏览器，使用QTextEdit，并使用setReadOnly设置为只读。如果您只需要显示一小段富文本，请使用QLabel即可。

二、QTextBrowser类

1、openExternalLinks

        该属性表示是否直接调用QDesktopServices::openUrl()打开外部链接，如果为false，那么将发出anchorClicked信号。

bool openExternalLinks() const
void setOpenExternalLinks(bool open)

2、openLinks

        该属性指定QTextBrowser是否应该自动打开用户试图通过鼠标或键盘激活的链接。不管这个属性的值是多少，总是会发出anchorClicked信号。

bool openLinks() const
void setOpenLinks(bool open)

3、searchPaths

        该属性保存文本浏览器用于查找支持内容的搜索路径，QTextBrowser使用这个列表来定位图像和文档。

QStringList searchPaths() const
void setSearchPaths(const QStringList &paths)

4、source

        该属性表示显示的文档资源。

QUrl source() const
virtual void setSource(const QUrl &name)
void setSource(const QUrl &url, QTextDocument::ResourceType type)

5、公共方法

1）backwardHistoryCount

        返回历史记录中向后的位置数。

int backwardHistoryCount() const

2）clearHistory

        清除已访问文档的历史记录，禁用前进和后退导航。

void clearHistory()

3）forwardHistoryCount

        返回历史记录中前进的位置数。

int forwardHistoryCount() const

4）historyTitle

        返回索引下的文档标题，索引小于0为后退记录，大于0为前进记录。

 QString historyTitle(int i) const

5）historyUrl

        返回索引下的url链接，索引小于0为后退记录，大于0为前进记录。

QUrl historyUrl(int i) const

6）isBackwardAvailable

        返回是否可后退。

bool isBackwardAvailable() const

7）isForwardAvailable

        返回是否可前进。

bool isForwardAvailable() const

6、公共槽函数

virtual void backward()        //后退
virtual void forward()         //前进
virtual void home()            //回到首页
virtual void reload()          //重新加载

7、信号

//用户点击锚点触发
void anchorClicked(const QUrl &link)

//可后退触发
void backwardAvailable(bool available)

//可前进触发
void forwardAvailable(bool available)

//高亮触发
void highlighted(const QUrl &link)

//历史记录改变触发
void historyChanged()

//资源文件改变触发
void sourceChanged(const QUrl &src)