QTextBrowser¶
Synopsis¶
Functions¶
- def backwardHistoryCount ()
- def clearHistory ()
- def forwardHistoryCount ()
- def historyTitle (arg__1)
- def historyUrl (arg__1)
- def isBackwardAvailable ()
- def isForwardAvailable ()
- def openExternalLinks ()
- def openLinks ()
- def searchPaths ()
- def setOpenExternalLinks (open)
- def setOpenLinks (open)
- def setSearchPaths (paths)
- def source ()
Signals¶
- def anchorClicked (arg__1)
- def backwardAvailable (arg__1)
- def forwardAvailable (arg__1)
- def highlighted (arg__1)
- def highlighted (arg__1)
- def historyChanged ()
- def sourceChanged (arg__1)
Detailed Description¶
The PySide.QtGui.QTextBrowser class provides a rich text browser with hypertext navigation.
This class extends PySide.QtGui.QTextEdit (in read-only mode), adding some navigation functionality so that users can follow links in hypertext documents.
If you want to provide your users with an editable rich text editor, use PySide.QtGui.QTextEdit . If you want a text browser without hypertext navigation use PySide.QtGui.QTextEdit , and use QTextEdit.setReadOnly() to disable editing. If you just need to display a small piece of rich text use PySide.QtGui.QLabel .
Document Source and Contents¶
The contents of PySide.QtGui.QTextEdit are set with PySide.QtGui.QTextEdit.setHtml() or PySide.QtGui.QTextEdit.setPlainText() , but PySide.QtGui.QTextBrowser also implements the PySide.QtGui.QTextBrowser.setSource() function, making it possible to use a named document as the source text. The name is looked up in a list of search paths and in the directory of the current document factory.
If a document name ends with an anchor (for example, “#anchor" ), the text browser automatically scrolls to that position (using PySide.QtGui.QTextEdit.scrollToAnchor() ). When the user clicks on a hyperlink, the browser will call PySide.QtGui.QTextBrowser.setSource() itself with the link’s href value as argument. You can track the current source by connecting to the PySide.QtGui.QTextBrowser.sourceChanged() signal.
