QTextBrowser 类

成员函数文档

[显式] QTextBrowser::QTextBrowser(QWidget *parent = nullptr)

使用父元素parent构建一个空的QTextBrowser。

[信号] void QTextBrowser::anchorClicked(const QUrl &link)

当用户点击锚点时发出此信号。通过锚点引用的URL传递给link。

请注意，除非将openLinks属性设置为false或您在连接的槽中调用setSource()，否则浏览器将自动处理link指定的位置导航。此机制用于覆盖浏览器的默认导航功能。

[虚拟槽] void QTextBrowser::backward()

将显示的文档更改为列表中通过链接导航构建的文档列表的上一文档。如果没有上一文档，则不执行任何操作。

另请参阅forward() 和 backwardAvailable()。

[信号] void QTextBrowser::backwardAvailable(bool available)

当backward()的可用性更改时发出此信号。available在用户处于主页时为false；否则为true。

int QTextBrowser::backwardHistoryCount() const

返回历史记录中的后退次数。

void QTextBrowser::clearHistory()

清除访问过的文档历史记录并禁用前后导航。

另请参阅backward() 和 forward()。

[虚拟受保护的] void QTextBrowser::doSetSource(const QUrl &url, QTextDocument::ResourceType type = QTextDocument::UnknownResource)

尝试加载给定 url 的文档，并指定 type。

setSource() 调用 doSetSource。在 Qt 5 中，setSource(const QUrl &url) 是虚拟的。在 Qt 6 中，doSetSource() 是虚拟的，这样就可以在子类中重写。

[重写虚拟受保护的] bool QTextBrowser::event(QEvent *e)

重新实现: QAbstractScrollArea::event(QEvent *event)。

[重写虚拟受保护的] bool QTextBrowser::focusNextPrevChild(bool next)

重新实现: QTextEdit::focusNextPrevChild(bool next)。

[重写虚拟受保护的] void QTextBrowser::focusOutEvent(QFocusEvent *ev)

重新实现: QTextEdit::focusOutEvent(QFocusEvent *e)。

[虚拟槽] void QTextBrowser::forward()

将显示的文档更改为列表中下一个文档。如果没有下一个文档，则不执行任何操作。

另请参阅backward() 和 forwardAvailable。

[信号] void QTextBrowser::forwardAvailable(bool available)

当 forward() 的可用性发生变化时发出此信号。在用户导航 backward() 后，available 为 true，当用户导航或转向 forward() 时为 false。

int QTextBrowser::forwardHistoryCount() const

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

[信号] void QTextBrowser::highlighted(const QUrl &link)

当用户已选中但未激活文档中的锚点时发出此信号。锚点引用的 URL 通过 link 传递。

[信号] void QTextBrowser::historyChanged()

当历史记录更改时发出此信号。

另请参阅historyTitle() 和 historyUrl。

QString QTextBrowser::historyTitle(int i) const

返回历史记录项的 documentTitle()。

backaction.setToolTip(browser.historyTitle(-1));
forwardaction.setToolTip(browser.historyTitle(+1));

QUrl QTextBrowser::historyUrl(int i) const

获取历史项的URL。

[虚拟槽] void QTextBrowser::home()

将显示的文档修改为历史中的第一个文档。

bool QTextBrowser::isBackwardAvailable() const

如果文本浏览器可以通过backward()在文档历史中向后导航，则返回true。

另请参阅 backwardAvailable() 和 backward。

bool QTextBrowser::isForwardAvailable() const

如果文本浏览器可以通过forward()在文档历史中向前导航，则返回true。

另请参阅 forwardAvailable() 和 forward。

[重写虚拟受保护的] void QTextBrowser::keyPressEvent(QKeyEvent *ev)

重新实现: QTextEdit::keyPressEvent(QKeyEvent *e)。

事件 ev 用于提供以下键盘快捷方式

[重写虚拟受保护的] QVariant QTextBrowser::loadResource(int type, const QUrl &name)

重新实现: QTextEdit::loadResource(int type, const QUrl &name)。

当文档加载以及文档中的每个图像加载时，都会调用此函数。如果无法加载资源，则返回一个无效的 QVariant。

默认实现忽略 type 并尝试通过解释 name 作为文件名来定位资源。如果它不是绝对路径，则尝试在 searchPaths 属性的路径以及当前源相同的目录中查找文件。成功时，结果是一个存储文件内容的 QVariant。

如果您重写此函数，可以返回其他 QVariant 类型。下表显示了根据资源类型支持哪些变体类型

[重写虚拟受保护的] void QTextBrowser::mouseMoveEvent(QMouseEvent *e)

重新实现: QTextEdit::mouseMoveEvent(QMouseEvent *e)。

[重写虚拟受保护的] void QTextBrowser::mousePressEvent(QMouseEvent *e)

重新实现: QTextEdit::mousePressEvent(QMouseEvent *e)。

[重写虚拟受保护] void QTextBrowser::mouseReleaseEvent(QMouseEvent *e)

重写: QTextEdit::mouseReleaseEvent(QMouseEvent *e).

[重写虚拟受保护] void QTextBrowser::paintEvent(QPaintEvent *e)

重写: QTextEdit::paintEvent(QPaintEvent *event).

[虚拟槽] void QTextBrowser::reload()

重新加载当前源。

[槽] void QTextBrowser::setSource(const QUrl &url, QTextDocument::ResourceType type = QTextDocument::UnknownResource)

尝试加载给定 url 的文档，并指定 type。

如果 type 是 UnknownResource （默认），则将检测文档类型：也就是说，如果 url 以扩展名 .md，.mkd 或 .markdown 结尾，将通过 QTextDocument::setMarkdown() 加载文档；否则，将通过 QTextDocument::setHtml() 加载。可以通过显式指定 type 来绕过此检测。

另请参阅：source（）。

[信号] void QTextBrowser::sourceChanged(const QUrl &src)

当源已更改时发出此信号，src 是新源。

源更改发生在通过调用 setSource（），forward（），backward（）或 home（）进行程序调用时，或在用户点击链接或按等效键序列时。