QTextBrowser Class Reference

[QtGui module]

中，QTextBrowser类提供了超文本浏览丰富的文本浏览器。More…

继承QTextEdit。

Methods

• __init__ (self, QWidget parent = None)
• backward (self)
• int backwardHistoryCount (self)
• clearHistory (self)
• bool event (self, QEvent e)
• bool focusNextPrevChild (self, bool next)
• focusOutEvent (self, QFocusEvent ev)
• forward (self)
• int forwardHistoryCount (self)
• QString historyTitle (self, int)
• QUrl historyUrl (self, int)
• home (self)
• bool isBackwardAvailable (self)
• bool isForwardAvailable (self)
• keyPressEvent (self, QKeyEvent ev)
• QVariant loadResource (self, int type, QUrl name)
• mouseMoveEvent (self, QMouseEvent ev)
• mousePressEvent (self, QMouseEvent ev)
• mouseReleaseEvent (self, QMouseEvent ev)
• bool openExternalLinks (self)
• bool openLinks (self)
• paintEvent (self, QPaintEvent e)
• reload (self)
• QStringList searchPaths (self)
• setOpenExternalLinks (self, bool open)
• setOpenLinks (self, bool open)
• setSearchPaths (self, QStringList paths)
• setSource (self, QUrl name)
• QUrl source (self)

Qt Signals

• void anchorClicked (const QUrl&)
• void backwardAvailable (bool)
• void forwardAvailable (bool)
• void highlighted (const QUrl&)
• void highlighted (const QString&)
• void historyChanged ()
• void sourceChanged (const QUrl&)

Detailed Description

中，QTextBrowser类提供了超文本浏览丰富的文本浏览器。

此类扩展QTextEdit（在只读模式下） ，添加一些导航功能，以便用户可以按照超文本文件的链接。

如果您想为您的用户提供了一个可编辑的富文本编辑器，使用QTextEdit。如果你想不超文本导航使用文本浏览器QTextEdit和使用QTextEdit.setReadOnly（ ）禁用编辑。如果你只是需要显示一小块富文本使用QLabel。

Document Source and Contents

的内容QTextEdit设置与setHtml（）或setPlainText（ ） ，但QTextBrowser也实现了setSource（）函数，使得可以使用命名文件的源文本。该名称抬头的搜索路径列表，并在当前文档工厂的目录。

如果一个文件名与一个锚（例如， “结束#anchor"） ，文本浏览器会自动滚动到该位置（使用scrollToAnchor（））。当用户点击一个超链接时，浏览器会调用setSource（ ）本身带有链接的href值作为参数。您可以通过连接到跟踪电流源sourceChanged（）信号。

Navigation

QTextBrowser提供backward（）和forward（ ）插槽，你可以用它来实现后退和前进按钮。该home（）槽设置文本显示的第一个文件。该anchorClicked当用户点击一个锚（ ）信号被发射。要复盖浏览器的默认导航行为，请拨打setSource（ ）函数在连接到该信号插槽提供新的文档中的文本。

如果要加载存储在Qt的资源系统中使用的文件qrc作为URL的方式来加载。例如，对于文件资源路径:/docs/index.html使用qrc:/docs/index.html作为与URLsetSource（ ） 。要访问本地文件，使用file作为URL的方案。

Method Documentation

QTextBrowser.__init__ (self, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个空QTextBrowser与父parent。

QTextBrowser.backward (self)

这种方法也是一个Qt槽与C + +的签名void backward()。

变化的通过导航链接建立文件列表中显示先前的文档的文档。什么都不做，如果没有以前的文档。

See also forward（）和backwardAvailable（ ） 。

int QTextBrowser.backwardHistoryCount (self)

返回的位置数落后的历史。

此功能被引入Qt的4.4 。

QTextBrowser.clearHistory (self)

清除访问了文件的历史和禁用向前和向后导航。

这个函数中引入了Qt 4.2中。

See also backward（）和forward（ ） 。

bool QTextBrowser.event (self, QEvent e)

从重新实现QObject.event（ ） 。

bool QTextBrowser.focusNextPrevChild (self, bool next)

从重新实现QWidget.focusNextPrevChild（ ） 。

QTextBrowser.focusOutEvent (self, QFocusEvent ev)

从重新实现QWidget.focusOutEvent（ ） 。

QTextBrowser.forward (self)

这种方法也是一个Qt槽与C + +的签名void forward()。

更改显示在通过导航链接建立文件列表中的下一个文档的文档。什么都不做，如果没有下一个文件。

See also backward（）和forwardAvailable（ ） 。

int QTextBrowser.forwardHistoryCount (self)

返回的位置数前进的历史。

此功能被引入Qt的4.4 。

QString QTextBrowser.historyTitle (self, int)

返回documentTitle该HistoryItem的（ ） 。

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

此功能被引入Qt的4.4 。

QUrl QTextBrowser.historyUrl (self, int)

[

返回HistoryItem的url 。

此功能被引入Qt的4.4 。

QTextBrowser.home (self)

这种方法也是一个Qt槽与C + +的签名void home()。

改变显示的是从历史中第一个文档的文档。

bool QTextBrowser.isBackwardAvailable (self)

](qurl.html)

返回True如果文本浏览器可以向后走在历史文件使用backward（ ） 。

这个函数中引入了Qt 4.2中。

See also backwardAvailable（）和backward（ ） 。

bool QTextBrowser.isForwardAvailable (self)

返回True如果文本浏览器可以前进中的文档历史记录使用forward（ ） 。

这个函数中引入了Qt 4.2中。

See also forwardAvailable（）和forward（ ） 。

QTextBrowser.keyPressEvent (self, QKeyEvent ev)

从重新实现QWidget.keyPressEvent（ ） 。

本次活动ev用于提供以下键盘快捷键：

QVariant QTextBrowser.loadResource (self, int type, QUrl name)

从重新实现QTextEdit.loadResource（ ） 。

这个函数在文件被加载时被调用，并且对文档中的每个图像。该type表示要加载的资源的类型。无效的QVariant如果无法加载该资源将被返回。

默认实现忽略type并试图通过解释来定位资源name作为文件名。如果它不是一个绝对路径，它试图找到文件中的路径searchPaths属性，并在相同的目录中的电流源。如果成功，则结果为一QVariant其存储QByteArray与该文件的内容。

如果你重新实现这个功能，你可以返回其他QVariant类型。下面哪一个变量的类型是根据资源的类型支持表所示：

QTextBrowser.mouseMoveEvent (self, QMouseEvent ev)

从重新实现QWidget.mouseMoveEvent（ ） 。

QTextBrowser.mousePressEvent (self, QMouseEvent ev)

从重新实现QWidget.mousePressEvent（ ） 。

QTextBrowser.mouseReleaseEvent (self, QMouseEvent ev)

从重新实现QWidget.mouseReleaseEvent（ ） 。

bool QTextBrowser.openExternalLinks (self)

bool QTextBrowser.openLinks (self)

QTextBrowser.paintEvent (self, QPaintEvent e)

从重新实现QWidget.paintEvent（ ） 。

QTextBrowser.reload (self)

这种方法也是一个Qt槽与C + +的签名void reload()。

重新加载当前组源。

QStringList QTextBrowser.searchPaths (self)

QTextBrowser.setOpenExternalLinks (self, bool open)

QTextBrowser.setOpenLinks (self, bool open)

QTextBrowser.setSearchPaths (self, QStringList paths)

QTextBrowser.setSource (self, QUrl name)

这种方法也是一个Qt槽与C + +的签名void setSource(const QUrl&)。

QUrl QTextBrowser.source (self)

[

Qt Signal Documentation

void anchorClicked (const QUrl&)

这是该信号的默认超载。

当用户点击一个锚这个信号被发射。由锚所指的URL传递中link。

](docs_qurl.html)

请注意，浏览器会自动处理导航到所指定的位置link除非openLinks属性设置为False ，或者您致电setSource（ ）在连接的插槽。这种机制被用于重写浏览器的默认导航功能。

void backwardAvailable (bool)

这是该信号的默认超载。

这个信号被发射时的可用性的backward（）的变化。available为假，当用户是在home（ ），否则它是真实的。

void forwardAvailable (bool)

这是该信号的默认超载。

这个信号被发射时的可用性的forward（）的变化。available是真实的用户浏览后backward（ ），当用户浏览或为假forward（ ） 。

void highlighted (const QUrl&)

这是该信号的默认超载。

当用户已选择但尚未激活的锚定文档中的这个信号被发射。由锚所指的URL传递中link。

void highlighted (const QString&)

这是一个重载函数。

允许连接到一个插槽，只需要在便利信号QString，例如像QStatusBar的消息（ ） 。

void historyChanged ()

这是该信号的默认超载。

当历史改变这个信号被发射。

此功能被引入Qt的4.4 。

See also historyTitle（）和historyUrl（ ） 。

void sourceChanged (const QUrl&)

这是该信号的默认超载。

这个信号被发射时在源发生了变化，src作为新来源。

来源发生变化既编程方式调用时，setSource（ ）forward（） ，退后（）或home（ ），或者当用户点击链接或按压等效键序列。