QTextBrowser Class Reference · PyQt4 中文文檔

# QTextBrowser Class Reference ## [[QtGui](index.htm) module] 中，QTextBrowser類提供了超文本瀏覽豐富的文本瀏覽器。[More...](#details) 繼承[QTextEdit](qtextedit.html)。 ### 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.html)（在只讀模式下），添加一些導航功能，以便用戶可以按照超文本文件的鏈接。如果您想為您的用戶提供了一個可編輯的富文本編輯器，使用[QTextEdit](qtextedit.html)。如果你想不超文本導航使用文本瀏覽器[QTextEdit](qtextedit.html)和使用[QTextEdit.setReadOnly](qtextedit.html#readOnly-prop)（）禁用編輯。如果你只是需要顯示一小塊富文本使用[QLabel](qlabel.html)。 ### Document Source and Contents 的內容[QTextEdit](qtextedit.html)設置與[setHtml](qtextedit.html#html-prop)（）或[setPlainText](qtextedit.html#plainText-prop)（），但QTextBrowser也實現了[setSource](qtextbrowser.html#source-prop)（）函數，使得可以使用命名文件的源文本。該名稱抬頭的搜索路徑列表，并在當前文檔工廠的目錄。如果一個文件名與一個錨（例如， “結束`#anchor"`），文本瀏覽器會自動滾動到該位置（使用[scrollToAnchor](qtextedit.html#scrollToAnchor)（））。當用戶點擊一個超鏈接時，瀏覽器會調用[setSource](qtextbrowser.html#source-prop)（）本身帶有鏈接的`href`值作為參數。您可以通過連接到跟蹤電流源[sourceChanged](qtextbrowser.html#sourceChanged)（）信號。 ### Navigation QTextBrowser提供[backward](qtextbrowser.html#backward)（）和[forward](qtextbrowser.html#forward)（）插槽，你可以用它來實現后退和前進按鈕。該[home](qtextbrowser.html#home)（）槽設置文本顯示的第一個文件。該[anchorClicked](qtextbrowser.html#anchorClicked)當用戶點擊一個錨（）信號被發射。要復蓋瀏覽器的默認導航行為，請撥打[setSource](qtextbrowser.html#source-prop)（）函數在連接到該信號插槽提供新的文檔中的文本。如果要加載存儲在Qt的資源系統中使用的文件`qrc`作為URL的方式來加載。例如，對于文件資源路徑`:/docs/index.html`使用`qrc:/docs/index.html`作為與URL[setSource](qtextbrowser.html#source-prop)（）。要訪問本地文件，使用`file`作為URL的方案。 * * * ## Method Documentation ``` QTextBrowser.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個空[QTextBrowser](qtextbrowser.html)與父_parent_。 ``` QTextBrowser.backward (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void backward()`。變化的通過導航鏈接建立文件列表中顯示先前的文檔的文檔。什么都不做，如果沒有以前的文檔。 **See also** [forward](qtextbrowser.html#forward)（）和[backwardAvailable](qtextbrowser.html#backwardAvailable)（）。 ``` int QTextBrowser.backwardHistoryCount (self) ``` 返回的位置數落后的歷史。此功能被引入Qt的4.4 。 ``` QTextBrowser.clearHistory (self) ``` 清除訪問了文件的歷史和禁用向前和向后導航。這個函數中引入了Qt 4.2中。 **See also** [backward](qtextbrowser.html#backward)（）和[forward](qtextbrowser.html#forward)（）。 ``` bool QTextBrowser.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` bool QTextBrowser.focusNextPrevChild (self, bool?next) ``` 從重新實現[QWidget.focusNextPrevChild](qwidget.html#focusNextPrevChild)（）。 ``` QTextBrowser.focusOutEvent (self, QFocusEvent?ev) ``` 從重新實現[QWidget.focusOutEvent](qwidget.html#focusOutEvent)（）。 ``` QTextBrowser.forward (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void forward()`。更改顯示在通過導航鏈接建立文件列表中的下一個文檔的文檔。什么都不做，如果沒有下一個文件。 **See also** [backward](qtextbrowser.html#backward)（）和[forwardAvailable](qtextbrowser.html#forwardAvailable)（）。 ``` int QTextBrowser.forwardHistoryCount (self) ``` 返回的位置數前進的歷史。此功能被引入Qt的4.4 。 ``` QString QTextBrowser.historyTitle (self, int) ``` 返回[documentTitle](qtextedit.html#documentTitle-prop)該HistoryItem的（）。 | Input | Return | | --- | --- | | _i_ < 0 | [backward](qtextbrowser.html#backward)() history | | _i_ == 0 | current, see [QTextBrowser.source](qtextbrowser.html#source-prop)() | | _i_ > 0 | [forward](qtextbrowser.html#forward)() history | ``` backaction.setToolTip(browser.historyTitle(-1)); forwardaction.setToolTip(browser.historyTitle(+1)); ``` 此功能被引入Qt的4.4 。 ``` QUrl QTextBrowser.historyUrl (self, int) ``` [ 返回HistoryItem的url 。 | Input | Return | | --- | --- | | _i_ < 0 | [backward](qtextbrowser.html#backward)() history | | _i_ == 0 | current, see [QTextBrowser.source](qtextbrowser.html#source-prop)() | | _i_ > 0 | [forward](qtextbrowser.html#forward)() history | 此功能被引入Qt的4.4 。 ``` QTextBrowser.home (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void home()`。改變顯示的是從歷史中第一個文檔的文檔。 ``` bool QTextBrowser.isBackwardAvailable (self) ``` ](qurl.html) [返回True如果文本瀏覽器可以向后走在歷史文件使用](qurl.html)[backward](qtextbrowser.html#backward)（）。這個函數中引入了Qt 4.2中。 **See also** [backwardAvailable](qtextbrowser.html#backwardAvailable)（）和[backward](qtextbrowser.html#backward)（）。 ``` bool QTextBrowser.isForwardAvailable (self) ``` 返回True如果文本瀏覽器可以前進中的文檔歷史記錄使用[forward](qtextbrowser.html#forward)（）。這個函數中引入了Qt 4.2中。 **See also** [forwardAvailable](qtextbrowser.html#forwardAvailable)（）和[forward](qtextbrowser.html#forward)（）。 ``` QTextBrowser.keyPressEvent (self, QKeyEvent?ev) ``` 從重新實現[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（）。本次活動_ev_用于提供以下鍵盤快捷鍵： | Keypress | Action | | --- | --- | | Alt+Left Arrow | [backward](qtextbrowser.html#backward)() | | Alt+Right Arrow | [forward](qtextbrowser.html#forward)() | | Alt+Up Arrow | [home](qtextbrowser.html#home)() | ``` QVariant QTextBrowser.loadResource (self, int?type, QUrl?name) ``` 從重新實現[QTextEdit.loadResource](qtextedit.html#loadResource)（）。這個函數在文件被加載時被調用，并且對文檔中的每個圖像。該_type_表示要加載的資源的類型。無效的[QVariant](qvariant.html)如果無法加載該資源將被返回。默認實現忽略_type_并試圖通過解釋來定位資源_name_作為文件名。如果它不是一個絕對路徑，它試圖找到文件中的路徑[searchPaths](qtextbrowser.html#searchPaths-prop)屬性，并在相同的目錄中的電流源。如果成功，則結果為一[QVariant](qvariant.html)其存儲[QByteArray](qbytearray.html)與該文件的內容。如果你重新實現這個功能，你可以返回其他[QVariant](qvariant.html)類型。下面哪一個變量的類型是根據資源的類型支持表所示： | ResourceType | [QVariant.Type](qvariant.html#Type-enum) | | --- | --- | | [QTextDocument.HtmlResource](qtextdocument.html#ResourceType-enum) | [QString](qstring.html) or [QByteArray](qbytearray.html) | | [QTextDocument.ImageResource](qtextdocument.html#ResourceType-enum) | [QImage](qimage.html), [QPixmap](qpixmap.html) or [QByteArray](qbytearray.html) | | [QTextDocument.StyleSheetResource](qtextdocument.html#ResourceType-enum) | [QString](qstring.html) or [QByteArray](qbytearray.html) | ``` QTextBrowser.mouseMoveEvent (self, QMouseEvent?ev) ``` 從重新實現[QWidget.mouseMoveEvent](qwidget.html#mouseMoveEvent)（）。 ``` QTextBrowser.mousePressEvent (self, QMouseEvent?ev) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（）。 ``` QTextBrowser.mouseReleaseEvent (self, QMouseEvent?ev) ``` 從重新實現[QWidget.mouseReleaseEvent](qwidget.html#mouseReleaseEvent)（）。 ``` bool QTextBrowser.openExternalLinks (self) ``` ``` bool QTextBrowser.openLinks (self) ``` ``` QTextBrowser.paintEvent (self, QPaintEvent?e) ``` 從重新實現[QWidget.paintEvent](qwidget.html#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_。 ](qurl.html) [請注意，瀏覽器會自動處理導航到所指定的位置_link_除非](qurl.html)[openLinks](qtextbrowser.html#openLinks-prop)屬性設置為False ，或者您致電[setSource](qtextbrowser.html#source-prop)（）在連接的插槽。這種機制被用于重寫瀏覽器的默認導航功能。 ``` void backwardAvailable (bool) ``` 這是該信號的默認超載。這個信號被發射時的可用性的[backward](qtextbrowser.html#backward)（）的變化。_available_為假，當用戶是在[home](qtextbrowser.html#home)（），否則它是真實的。 ``` void forwardAvailable (bool) ``` 這是該信號的默認超載。這個信號被發射時的可用性的[forward](qtextbrowser.html#forward)（）的變化。_available_是真實的用戶瀏覽后[backward](qtextbrowser.html#backward)（），當用戶瀏覽或為假[forward](qtextbrowser.html#forward)（）。 ``` void highlighted (const QUrl&) ``` 這是該信號的默認超載。當用戶已選擇但尚未激活的錨定文檔中的這個信號被發射。由錨所指的URL傳遞中_link_。 ``` void highlighted (const QString&) ``` 這是一個重載函數。允許連接到一個插槽，只需要在便利信號[QString](qstring.html)，例如像[QStatusBar](qstatusbar.html)的消息（）。 ``` void historyChanged () ``` 這是該信號的默認超載。當歷史改變這個信號被發射。此功能被引入Qt的4.4 。 **See also** [historyTitle](qtextbrowser.html#historyTitle)（）和[historyUrl](qtextbrowser.html#historyUrl)（）。 ``` void sourceChanged (const QUrl&) ``` 這是該信號的默認超載。這個信號被發射時在源發生了變化，_src_作為新來源。來源發生變化既編程方式調用時，[setSource](qtextbrowser.html#source-prop)（）[forward](qtextbrowser.html#forward)（），退后（）或[home](qtextbrowser.html#home)（），或者當用戶點擊鏈接或按壓等效鍵序列。