File: qtextbrowser.html

package info (click to toggle)
python-qt4 4.12.1%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 40,300 kB
  • ctags: 6,185
  • sloc: python: 125,988; cpp: 13,291; xml: 292; makefile: 246; php: 27; sh: 2
file content (277 lines) | stat: -rw-r--r-- 22,669 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html><head><title>QTextBrowser Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
td.postheader { font-family: sans-serif }
tr.address { font-family: sans-serif }
body { background: #ffffff; color: black; }
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">&#160;&#160;</td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a>&#160;&#183; <a href="classes.html"><font color="#004faf">All Classes</font></a>&#160;&#183; <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QTextBrowser Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1><p>The QTextBrowser class provides a rich text browser with
hypertext navigation. <a href="#details">More...</a></p>

<p>Inherits <a href="qtextedit.html">QTextEdit</a>.</p><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qtextbrowser.html#QTextBrowser">__init__</a></b> (<i>self</i>, QWidget&#160;<i>parent</i>&#160;=&#160;None)</li><li><div class="fn" /><b><a href="qtextbrowser.html#backward">backward</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qtextbrowser.html#backwardHistoryCount">backwardHistoryCount</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#clearHistory">clearHistory</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qtextbrowser.html#event">event</a></b> (<i>self</i>, QEvent&#160;<i>e</i>)</li><li><div class="fn" />bool <b><a href="qtextbrowser.html#focusNextPrevChild">focusNextPrevChild</a></b> (<i>self</i>, bool&#160;<i>next</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#focusOutEvent">focusOutEvent</a></b> (<i>self</i>, QFocusEvent&#160;<i>ev</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#forward">forward</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qtextbrowser.html#forwardHistoryCount">forwardHistoryCount</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qtextbrowser.html#historyTitle">historyTitle</a></b> (<i>self</i>, int)</li><li><div class="fn" />QUrl <b><a href="qtextbrowser.html#historyUrl">historyUrl</a></b> (<i>self</i>, int)</li><li><div class="fn" /><b><a href="qtextbrowser.html#home">home</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qtextbrowser.html#isBackwardAvailable">isBackwardAvailable</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qtextbrowser.html#isForwardAvailable">isForwardAvailable</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#keyPressEvent">keyPressEvent</a></b> (<i>self</i>, QKeyEvent&#160;<i>ev</i>)</li><li><div class="fn" />QVariant <b><a href="qtextbrowser.html#loadResource">loadResource</a></b> (<i>self</i>, int&#160;<i>type</i>, QUrl&#160;<i>name</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#mouseMoveEvent">mouseMoveEvent</a></b> (<i>self</i>, QMouseEvent&#160;<i>ev</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#mousePressEvent">mousePressEvent</a></b> (<i>self</i>, QMouseEvent&#160;<i>ev</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#mouseReleaseEvent">mouseReleaseEvent</a></b> (<i>self</i>, QMouseEvent&#160;<i>ev</i>)</li><li><div class="fn" />bool <b><a href="qtextbrowser.html#openExternalLinks">openExternalLinks</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qtextbrowser.html#openLinks">openLinks</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#paintEvent">paintEvent</a></b> (<i>self</i>, QPaintEvent&#160;<i>e</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#reload">reload</a></b> (<i>self</i>)</li><li><div class="fn" />QStringList <b><a href="qtextbrowser.html#searchPaths">searchPaths</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#setOpenExternalLinks">setOpenExternalLinks</a></b> (<i>self</i>, bool&#160;<i>open</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#setOpenLinks">setOpenLinks</a></b> (<i>self</i>, bool&#160;<i>open</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#setSearchPaths">setSearchPaths</a></b> (<i>self</i>, QStringList&#160;<i>paths</i>)</li><li><div class="fn" /><b><a href="qtextbrowser.html#setSource">setSource</a></b> (<i>self</i>, QUrl&#160;<i>name</i>)</li><li><div class="fn" />QUrl <b><a href="qtextbrowser.html#source">source</a></b> (<i>self</i>)</li></ul><h3>Qt Signals</h3><ul><li><div class="fn" />void <b><a href="qtextbrowser.html#anchorClicked">anchorClicked</a></b> (const  ::QUrl&amp;)</li><li><div class="fn" />void <b><a href="qtextbrowser.html#backwardAvailable">backwardAvailable</a></b> (bool)</li><li><div class="fn" />void <b><a href="qtextbrowser.html#forwardAvailable">forwardAvailable</a></b> (bool)</li><li><div class="fn" />void <b><a href="qtextbrowser.html#highlighted">highlighted</a></b> (const  ::QUrl&amp;)</li><li><div class="fn" />void <b><a href="qtextbrowser.html#highlighted-2">highlighted</a></b> (const QString&amp;)</li><li><div class="fn" />void <b><a href="qtextbrowser.html#historyChanged">historyChanged</a></b> ()</li><li><div class="fn" />void <b><a href="qtextbrowser.html#sourceChanged">sourceChanged</a></b> (const  ::QUrl&amp;)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QTextBrowser class provides a rich text browser with
hypertext navigation.</p>
<p>This class extends <a href="qtextedit.html">QTextEdit</a> (in
read-only mode), adding some navigation functionality so that users
can follow links in hypertext documents.</p>
<p>If you want to provide your users with an editable rich text
editor, use <a href="qtextedit.html">QTextEdit</a>. If you want a
text browser without hypertext navigation use <a href="qtextedit.html">QTextEdit</a>, and use <a href="qtextedit.html#readOnly-prop">QTextEdit.setReadOnly</a>() to
disable editing. If you just need to display a small piece of rich
text use <a href="qlabel.html">QLabel</a>.</p>
<a id="document-source-and-contents" name="document-source-and-contents" />
<h3>Document Source and Contents</h3>
<p>The contents of <a href="qtextedit.html">QTextEdit</a> are set
with <a href="qtextedit.html#html-prop">setHtml</a>() or <a href="qtextedit.html#plainText-prop">setPlainText</a>(), but
QTextBrowser also implements the <a href="qtextbrowser.html#source-prop">setSource</a>() 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.</p>
<p>If a document name ends with an anchor (for example,
"<tt>#anchor"</tt>), the text browser automatically scrolls to that
position (using <a href="qtextedit.html#scrollToAnchor">scrollToAnchor</a>()). When the
user clicks on a hyperlink, the browser will call <a href="qtextbrowser.html#source-prop">setSource</a>() itself with the
link's <tt>href</tt> value as argument. You can track the current
source by connecting to the <a href="qtextbrowser.html#sourceChanged">sourceChanged</a>() signal.</p>
<a id="navigation" name="navigation" />
<h3>Navigation</h3>
<p>QTextBrowser provides <a href="qtextbrowser.html#backward">backward</a>() and <a href="qtextbrowser.html#forward">forward</a>() slots which you can use
to implement Back and Forward buttons. The <a href="qtextbrowser.html#home">home</a>() slot sets the text to the very
first document displayed. The <a href="qtextbrowser.html#anchorClicked">anchorClicked</a>() signal is
emitted when the user clicks an anchor. To override the default
navigation behavior of the browser, call the <a href="qtextbrowser.html#source-prop">setSource</a>() function to supply
new document text in a slot connected to this signal.</p>
<p>If you want to load documents stored in the Qt resource system
use <tt>qrc</tt> as the scheme in the URL to load. For example, for
the document resource path <tt>:/docs/index.html</tt> use
<tt>qrc:/docs/index.html</tt> as the URL with <a href="qtextbrowser.html#source-prop">setSource</a>(). To access local
files, use <tt>file</tt> as the scheme in the URL.</p>
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QTextBrowser" />QTextBrowser.__init__ (<i>self</i>, <a href="qwidget.html">QWidget</a>&#160;<i>parent</i>&#160;=&#160;None)</h3><p>The <i>parent</i> argument, if not None, causes <i>self</i> to be owned by Qt instead of PyQt.</p><p>Constructs an empty <a href="qtextbrowser.html">QTextBrowser</a>
with parent <i>parent</i>.</p>


<h3 class="fn"><a name="backward" />QTextBrowser.backward (<i>self</i>)</h3><p>This method is also a Qt slot with the C++ signature <tt>void backward()</tt>.</p><p>Changes the document displayed to the previous document in the
list of documents built by navigating links. Does nothing if there
is no previous document.</p>
<p><b>See also</b> <a href="qtextbrowser.html#forward">forward</a>() and <a href="qtextbrowser.html#backwardAvailable">backwardAvailable</a>().</p>


<h3 class="fn"><a name="backwardHistoryCount" />int QTextBrowser.backwardHistoryCount (<i>self</i>)</h3><p>Returns the number of locations backward in the history.</p>
<p>This function was introduced in Qt 4.4.</p>


<h3 class="fn"><a name="clearHistory" />QTextBrowser.clearHistory (<i>self</i>)</h3><p>Clears the history of visited documents and disables the forward
and backward navigation.</p>
<p>This function was introduced in Qt 4.2.</p>
<p><b>See also</b> <a href="qtextbrowser.html#backward">backward</a>() and <a href="qtextbrowser.html#forward">forward</a>().</p>


<h3 class="fn"><a name="event" />bool QTextBrowser.event (<i>self</i>, <a href="qevent.html">QEvent</a>&#160;<i>e</i>)</h3><p>Reimplemented from <a href="qobject.html#event">QObject.event</a>().</p>


<h3 class="fn"><a name="focusNextPrevChild" />bool QTextBrowser.focusNextPrevChild (<i>self</i>, bool&#160;<i>next</i>)</h3><p>Reimplemented from <a href="qwidget.html#focusNextPrevChild">QWidget.focusNextPrevChild</a>().</p>


<h3 class="fn"><a name="focusOutEvent" />QTextBrowser.focusOutEvent (<i>self</i>, <a href="qfocusevent.html">QFocusEvent</a>&#160;<i>ev</i>)</h3><p>Reimplemented from <a href="qwidget.html#focusOutEvent">QWidget.focusOutEvent</a>().</p>


<h3 class="fn"><a name="forward" />QTextBrowser.forward (<i>self</i>)</h3><p>This method is also a Qt slot with the C++ signature <tt>void forward()</tt>.</p><p>Changes the document displayed to the next document in the list
of documents built by navigating links. Does nothing if there is no
next document.</p>
<p><b>See also</b> <a href="qtextbrowser.html#backward">backward</a>() and <a href="qtextbrowser.html#forwardAvailable">forwardAvailable</a>().</p>


<h3 class="fn"><a name="forwardHistoryCount" />int QTextBrowser.forwardHistoryCount (<i>self</i>)</h3><p>Returns the number of locations forward in the history.</p>
<p>This function was introduced in Qt 4.4.</p>


<h3 class="fn"><a name="historyTitle" />QString QTextBrowser.historyTitle (<i>self</i>, int)</h3><p>Returns the <a href="qtextedit.html#documentTitle-prop">documentTitle</a>() of the
HistoryItem.</p>
<table class="generic">
<thead>
<tr class="qt-style">
<th>Input</th>
<th>Return</th>
</tr>
</thead>
<tr class="odd" valign="top">
<td><i>i</i> &lt; 0</td>
<td><a href="qtextbrowser.html#backward">backward</a>()
history</td>
</tr>
<tr class="even" valign="top">
<td><i>i</i> == 0</td>
<td>current, see <a href="qtextbrowser.html#source-prop">QTextBrowser.source</a>()</td>
</tr>
<tr class="odd" valign="top">
<td><i>i</i> &gt; 0</td>
<td><a href="qtextbrowser.html#forward">forward</a>() history</td>
</tr>
</table>
<pre class="cpp">
 backaction<span class="operator">.</span><a href="qwidget.html#toolTip-prop">setToolTip</a>(browser<span class="operator">.</span>historyTitle(<span class="operator">-</span><span class="number">1</span>));
 forwardaction<span class="operator">.</span><a href="qwidget.html#toolTip-prop">setToolTip</a>(browser<span class="operator">.</span>historyTitle(<span class="operator">+</span><span class="number">1</span>));
</pre>
<p>This function was introduced in Qt 4.4.</p>


<h3 class="fn"><a name="historyUrl" /><a href="qurl.html">QUrl</a> QTextBrowser.historyUrl (<i>self</i>, int)</h3><p>Returns the url of the HistoryItem.</p>
<table class="generic">
<thead>
<tr class="qt-style">
<th>Input</th>
<th>Return</th>
</tr>
</thead>
<tr class="odd" valign="top">
<td><i>i</i> &lt; 0</td>
<td><a href="qtextbrowser.html#backward">backward</a>()
history</td>
</tr>
<tr class="even" valign="top">
<td><i>i</i> == 0</td>
<td>current, see <a href="qtextbrowser.html#source-prop">QTextBrowser.source</a>()</td>
</tr>
<tr class="odd" valign="top">
<td><i>i</i> &gt; 0</td>
<td><a href="qtextbrowser.html#forward">forward</a>() history</td>
</tr>
</table>
<p>This function was introduced in Qt 4.4.</p>


<h3 class="fn"><a name="home" />QTextBrowser.home (<i>self</i>)</h3><p>This method is also a Qt slot with the C++ signature <tt>void home()</tt>.</p><p>Changes the document displayed to be the first document from the
history.</p>


<h3 class="fn"><a name="isBackwardAvailable" />bool QTextBrowser.isBackwardAvailable (<i>self</i>)</h3><p>Returns true if the text browser can go backward in the document
history using <a href="qtextbrowser.html#backward">backward</a>().</p>
<p>This function was introduced in Qt 4.2.</p>
<p><b>See also</b> <a href="qtextbrowser.html#backwardAvailable">backwardAvailable</a>() and
<a href="qtextbrowser.html#backward">backward</a>().</p>


<h3 class="fn"><a name="isForwardAvailable" />bool QTextBrowser.isForwardAvailable (<i>self</i>)</h3><p>Returns true if the text browser can go forward in the document
history using <a href="qtextbrowser.html#forward">forward</a>().</p>
<p>This function was introduced in Qt 4.2.</p>
<p><b>See also</b> <a href="qtextbrowser.html#forwardAvailable">forwardAvailable</a>() and
<a href="qtextbrowser.html#forward">forward</a>().</p>


<h3 class="fn"><a name="keyPressEvent" />QTextBrowser.keyPressEvent (<i>self</i>, <a href="qkeyevent.html">QKeyEvent</a>&#160;<i>ev</i>)</h3><p>Reimplemented from <a href="qwidget.html#keyPressEvent">QWidget.keyPressEvent</a>().</p>
<p>The event <i>ev</i> is used to provide the following keyboard
shortcuts:</p>
<table class="generic">
<thead>
<tr class="qt-style">
<th>Keypress</th>
<th>Action</th>
</tr>
</thead>
<tr class="odd" valign="top">
<td>Alt+Left Arrow</td>
<td><a href="qtextbrowser.html#backward">backward</a>()</td>
</tr>
<tr class="even" valign="top">
<td>Alt+Right Arrow</td>
<td><a href="qtextbrowser.html#forward">forward</a>()</td>
</tr>
<tr class="odd" valign="top">
<td>Alt+Up Arrow</td>
<td><a href="qtextbrowser.html#home">home</a>()</td>
</tr>
</table>


<h3 class="fn"><a name="loadResource" />QVariant QTextBrowser.loadResource (<i>self</i>, int&#160;<i>type</i>, <a href="qurl.html">QUrl</a>&#160;<i>name</i>)</h3><p>Reimplemented from <a href="qtextedit.html#loadResource">QTextEdit.loadResource</a>().</p>
<p>This function is called when the document is loaded and for each
image in the document. The <i>type</i> indicates the type of
resource to be loaded. An invalid <a href="qvariant.html">QVariant</a> is returned if the resource cannot be
loaded.</p>
<p>The default implementation ignores <i>type</i> and tries to
locate the resources by interpreting <i>name</i> as a file name. If
it is not an absolute path it tries to find the file in the paths
of the <a href="qtextbrowser.html#searchPaths-prop">searchPaths</a>
property and in the same directory as the current source. On
success, the result is a <a href="qvariant.html">QVariant</a> that
stores a <a href="qbytearray.html">QByteArray</a> with the contents
of the file.</p>
<p>If you reimplement this function, you can return other <a href="qvariant.html">QVariant</a> types. The table below shows which
variant types are supported depending on the resource type:</p>
<table class="generic">
<thead>
<tr class="qt-style">
<th>ResourceType</th>
<th><a href="qvariant.html#Type-enum">QVariant.Type</a></th>
</tr>
</thead>
<tr class="odd" valign="top">
<td><a href="qtextdocument.html#ResourceType-enum">QTextDocument.HtmlResource</a></td>
<td><a href="qstring.html">QString</a> or <a href="qbytearray.html">QByteArray</a></td>
</tr>
<tr class="even" valign="top">
<td><a href="qtextdocument.html#ResourceType-enum">QTextDocument.ImageResource</a></td>
<td><a href="qimage.html">QImage</a>, <a href="qpixmap.html">QPixmap</a> or <a href="qbytearray.html">QByteArray</a></td>
</tr>
<tr class="odd" valign="top">
<td><a href="qtextdocument.html#ResourceType-enum">QTextDocument.StyleSheetResource</a></td>
<td><a href="qstring.html">QString</a> or <a href="qbytearray.html">QByteArray</a></td>
</tr>
</table>


<h3 class="fn"><a name="mouseMoveEvent" />QTextBrowser.mouseMoveEvent (<i>self</i>, <a href="qmouseevent.html">QMouseEvent</a>&#160;<i>ev</i>)</h3><p>Reimplemented from <a href="qwidget.html#mouseMoveEvent">QWidget.mouseMoveEvent</a>().</p>


<h3 class="fn"><a name="mousePressEvent" />QTextBrowser.mousePressEvent (<i>self</i>, <a href="qmouseevent.html">QMouseEvent</a>&#160;<i>ev</i>)</h3><p>Reimplemented from <a href="qwidget.html#mousePressEvent">QWidget.mousePressEvent</a>().</p>


<h3 class="fn"><a name="mouseReleaseEvent" />QTextBrowser.mouseReleaseEvent (<i>self</i>, <a href="qmouseevent.html">QMouseEvent</a>&#160;<i>ev</i>)</h3><p>Reimplemented from <a href="qwidget.html#mouseReleaseEvent">QWidget.mouseReleaseEvent</a>().</p>


<h3 class="fn"><a name="openExternalLinks" />bool QTextBrowser.openExternalLinks (<i>self</i>)</h3><h3 class="fn"><a name="openLinks" />bool QTextBrowser.openLinks (<i>self</i>)</h3><h3 class="fn"><a name="paintEvent" />QTextBrowser.paintEvent (<i>self</i>, <a href="qpaintevent.html">QPaintEvent</a>&#160;<i>e</i>)</h3><p>Reimplemented from <a href="qwidget.html#paintEvent">QWidget.paintEvent</a>().</p>


<h3 class="fn"><a name="reload" />QTextBrowser.reload (<i>self</i>)</h3><p>This method is also a Qt slot with the C++ signature <tt>void reload()</tt>.</p><p>Reloads the current set source.</p>


<h3 class="fn"><a name="searchPaths" />QStringList QTextBrowser.searchPaths (<i>self</i>)</h3><h3 class="fn"><a name="setOpenExternalLinks" />QTextBrowser.setOpenExternalLinks (<i>self</i>, bool&#160;<i>open</i>)</h3><h3 class="fn"><a name="setOpenLinks" />QTextBrowser.setOpenLinks (<i>self</i>, bool&#160;<i>open</i>)</h3><h3 class="fn"><a name="setSearchPaths" />QTextBrowser.setSearchPaths (<i>self</i>, QStringList&#160;<i>paths</i>)</h3><h3 class="fn"><a name="setSource" />QTextBrowser.setSource (<i>self</i>, <a href="qurl.html">QUrl</a>&#160;<i>name</i>)</h3><p>This method is also a Qt slot with the C++ signature <tt>void setSource(const  ::QUrl&amp;)</tt>.</p><h3 class="fn"><a name="source" /><a href="qurl.html">QUrl</a> QTextBrowser.source (<i>self</i>)</h3><hr /><h2>Qt Signal Documentation</h2><h3 class="fn"><a name="anchorClicked" />void anchorClicked (const  ::QUrl&amp;)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted when the user clicks an anchor. The URL
referred to by the anchor is passed in <i>link</i>.</p>
<p>Note that the browser will automatically handle navigation to
the location specified by <i>link</i> unless the <a href="qtextbrowser.html#openLinks-prop">openLinks</a> property is set to
false or you call <a href="qtextbrowser.html#source-prop">setSource</a>() in a slot
connected. This mechanism is used to override the default
navigation features of the browser.</p>


<h3 class="fn"><a name="backwardAvailable" />void backwardAvailable (bool)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted when the availability of <a href="qtextbrowser.html#backward">backward</a>() changes.
<i>available</i> is false when the user is at <a href="qtextbrowser.html#home">home</a>(); otherwise it is true.</p>


<h3 class="fn"><a name="forwardAvailable" />void forwardAvailable (bool)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted when the availability of <a href="qtextbrowser.html#forward">forward</a>() changes. <i>available</i>
is true after the user navigates <a href="qtextbrowser.html#backward">backward</a>() and false when the user
navigates or goes <a href="qtextbrowser.html#forward">forward</a>().</p>


<h3 class="fn"><a name="highlighted" />void highlighted (const  ::QUrl&amp;)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted when the user has selected but not
activated an anchor in the document. The URL referred to by the
anchor is passed in <i>link</i>.</p>


<h3 class="fn"><a name="highlighted-2" />void highlighted (const QString&amp;)</h3><p>This is an overloaded function.</p>
<p>Convenience signal that allows connecting to a slot that takes
just a <a href="qstring.html">QString</a>, like for example
<a href="qstatusbar.html">QStatusBar</a>'s message().</p>


<h3 class="fn"><a name="historyChanged" />void historyChanged ()</h3><p>This is the default overload of this signal.</p><p>This signal is emitted when the history changes.</p>
<p>This function was introduced in Qt 4.4.</p>
<p><b>See also</b> <a href="qtextbrowser.html#historyTitle">historyTitle</a>() and <a href="qtextbrowser.html#historyUrl">historyUrl</a>().</p>


<h3 class="fn"><a name="sourceChanged" />void sourceChanged (const  ::QUrl&amp;)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted when the source has changed, <i>src</i>
being the new source.</p>
<p>Source changes happen both programmatically when calling
<a href="qtextbrowser.html#source-prop">setSource</a>(), <a href="qtextbrowser.html#forward">forward</a>(), backword() or <a href="qtextbrowser.html#home">home</a>() or when the user clicks on
links or presses the equivalent key sequences.</p>
<address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt&#160;4.12.1 for X11</td><td align="center" width="50%">Copyright &#169; <a href="http://www.riverbankcomputing.com">Riverbank&#160;Computing&#160;Ltd</a> and <a href="http://www.qt.io">The Qt Company</a> 2015</td><td align="right" width="25%">Qt&#160;4.8.7</td></tr></table></div></address></body></html>