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
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
|
<?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>QWebElement 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">  </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QWebElement Class Reference<br /><sup><sup>[<a href="qtwebkit.html">QtWebKit</a> module]</sup></sup></h1><p>The QWebElement class provides convenient access to DOM elements
in a <a href="qwebframe.html">QWebFrame</a>. <a href="#details">More...</a></p>
<h3>Types</h3><ul><li><div class="fn" />enum <b><a href="qwebelement.html#StyleResolveStrategy-enum">StyleResolveStrategy</a></b> { InlineStyle, CascadedStyle, ComputedStyle }</li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qwebelement.html#QWebElement">__init__</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#QWebElement-2">__init__</a></b> (<i>self</i>, QWebElement)</li><li><div class="fn" /><b><a href="qwebelement.html#addClass">addClass</a></b> (<i>self</i>, QString <i>name</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#appendInside">appendInside</a></b> (<i>self</i>, QString <i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#appendInside-2">appendInside</a></b> (<i>self</i>, QWebElement <i>element</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#appendOutside">appendOutside</a></b> (<i>self</i>, QString <i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#appendOutside-2">appendOutside</a></b> (<i>self</i>, QWebElement <i>element</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#attribute">attribute</a></b> (<i>self</i>, QString <i>name</i>, QString <i>defaultValue</i> = '')</li><li><div class="fn" />QStringList <b><a href="qwebelement.html#attributeNames">attributeNames</a></b> (<i>self</i>, QString <i>namespaceUri</i> = '')</li><li><div class="fn" />QString <b><a href="qwebelement.html#attributeNS">attributeNS</a></b> (<i>self</i>, QString <i>namespaceUri</i>, QString <i>name</i>, QString <i>defaultValue</i> = '')</li><li><div class="fn" />QStringList <b><a href="qwebelement.html#classes">classes</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#clone">clone</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#document">document</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#encloseContentsWith">encloseContentsWith</a></b> (<i>self</i>, QWebElement <i>element</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#encloseContentsWith-2">encloseContentsWith</a></b> (<i>self</i>, QString <i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#encloseWith">encloseWith</a></b> (<i>self</i>, QString <i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#encloseWith-2">encloseWith</a></b> (<i>self</i>, QWebElement <i>element</i>)</li><li><div class="fn" />QVariant <b><a href="qwebelement.html#evaluateJavaScript">evaluateJavaScript</a></b> (<i>self</i>, QString <i>scriptSource</i>)</li><li><div class="fn" />QWebElementCollection <b><a href="qwebelement.html#findAll">findAll</a></b> (<i>self</i>, QString <i>selectorQuery</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#findFirst">findFirst</a></b> (<i>self</i>, QString <i>selectorQuery</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#firstChild">firstChild</a></b> (<i>self</i>)</li><li><div class="fn" />QRect <b><a href="qwebelement.html#geometry">geometry</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#hasAttribute">hasAttribute</a></b> (<i>self</i>, QString <i>name</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#hasAttributeNS">hasAttributeNS</a></b> (<i>self</i>, QString <i>namespaceUri</i>, QString <i>name</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#hasAttributes">hasAttributes</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#hasClass">hasClass</a></b> (<i>self</i>, QString <i>name</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#hasFocus">hasFocus</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#isNull">isNull</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#lastChild">lastChild</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#localName">localName</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#namespaceUri">namespaceUri</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#nextSibling">nextSibling</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#parent">parent</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#prefix">prefix</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#prependInside">prependInside</a></b> (<i>self</i>, QString <i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#prependInside-2">prependInside</a></b> (<i>self</i>, QWebElement <i>element</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#prependOutside">prependOutside</a></b> (<i>self</i>, QString <i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#prependOutside-2">prependOutside</a></b> (<i>self</i>, QWebElement <i>element</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#previousSibling">previousSibling</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#removeAllChildren">removeAllChildren</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#removeAttribute">removeAttribute</a></b> (<i>self</i>, QString <i>name</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#removeAttributeNS">removeAttributeNS</a></b> (<i>self</i>, QString <i>namespaceUri</i>, QString <i>name</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#removeClass">removeClass</a></b> (<i>self</i>, QString <i>name</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#removeFromDocument">removeFromDocument</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#render">render</a></b> (<i>self</i>, QPainter <i>painter</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#render-2">render</a></b> (<i>self</i>, QPainter <i>painter</i>, QRect <i>clip</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#replace">replace</a></b> (<i>self</i>, QString <i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#replace-2">replace</a></b> (<i>self</i>, QWebElement <i>element</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setAttribute">setAttribute</a></b> (<i>self</i>, QString <i>name</i>, QString <i>value</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setAttributeNS">setAttributeNS</a></b> (<i>self</i>, QString <i>namespaceUri</i>, QString <i>name</i>, QString <i>value</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setFocus">setFocus</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setInnerXml">setInnerXml</a></b> (<i>self</i>, QString <i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setOuterXml">setOuterXml</a></b> (<i>self</i>, QString <i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setPlainText">setPlainText</a></b> (<i>self</i>, QString <i>text</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setStyleProperty">setStyleProperty</a></b> (<i>self</i>, QString <i>name</i>, QString <i>value</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#styleProperty">styleProperty</a></b> (<i>self</i>, QString <i>name</i>, StyleResolveStrategy <i>strategy</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#tagName">tagName</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#takeFromDocument">takeFromDocument</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#toggleClass">toggleClass</a></b> (<i>self</i>, QString <i>name</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#toInnerXml">toInnerXml</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#toOuterXml">toOuterXml</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#toPlainText">toPlainText</a></b> (<i>self</i>)</li><li><div class="fn" />QWebFrame <b><a href="qwebelement.html#webFrame">webFrame</a></b> (<i>self</i>)</li></ul><h3>Special Methods</h3><ul><li><div class="fn" />bool <b><a href="qwebelement.html#__eq__">__eq__</a></b> (<i>self</i>, QWebElement <i>o</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#__ne__">__ne__</a></b> (<i>self</i>, QWebElement <i>o</i>)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QWebElement class provides convenient access to DOM elements
in a <a href="qwebframe.html">QWebFrame</a>.</p>
<p>A QWebElement object allows easy access to the document model,
represented by a tree-like structure of DOM elements. The root of
the tree is called the document element and can be accessed using
<a href="qwebframe.html#documentElement">QWebFrame.documentElement</a>().</p>
<p>Specific elements can be accessed using <a href="qwebelement.html#findAll">findAll</a>() and <a href="qwebelement.html#findFirst">findFirst</a>(). These elements are
identified using CSS selectors. The code snippet below demonstrates
the use of <a href="qwebelement.html#findAll">findAll</a>().</p>
<pre class="cpp">
<span class="type">QWebElement</span> document <span class="operator">=</span> frame<span class="operator">-</span><span class="operator">></span>documentElement();
<span class="comment">/* Assume the document has the following structure:
<p class=intro>
<span>Intro</span>
<span>Snippets</span>
</p>
<p>
<span>Content</span>
<span>Here</span>
</p>
*/</span>
<span class="type"><a href="qwebelementcollection.html">QWebElementCollection</a></span> allSpans <span class="operator">=</span> document<span class="operator">.</span>findAll(<span class="string">"span"</span>);
<span class="type"><a href="qwebelementcollection.html">QWebElementCollection</a></span> introSpans <span class="operator">=</span> document<span class="operator">.</span>findAll(<span class="string">"p.intro span"</span>);
</pre>
<p>The first list contains all <tt>span</tt> elements in the
document. The second list contains <tt>span</tt> elements that are
children of <tt>p</tt>, classified with <tt>intro</tt>.</p>
<p>Using <a href="qwebelement.html#findFirst">findFirst</a>() is
more efficient than calling <a href="qwebelement.html#findAll">findAll</a>(), and extracting the first
element only in the list returned.</p>
<p>Alternatively you can traverse the document manually using
<a href="qwebelement.html#firstChild">firstChild</a>() and <a href="qwebelement.html#nextSibling">nextSibling</a>():</p>
<pre class="cpp">
frame<span class="operator">-</span><span class="operator">></span>setHtml(<span class="string">"<html><body><p>First Paragraph</p><p>Second Paragraph</p></body></html>"</span>);
<span class="type">QWebElement</span> doc <span class="operator">=</span> frame<span class="operator">-</span><span class="operator">></span>documentElement();
<span class="type">QWebElement</span> body <span class="operator">=</span> doc<span class="operator">.</span>firstChild();
<span class="type">QWebElement</span> firstParagraph <span class="operator">=</span> body<span class="operator">.</span>firstChild();
<span class="type">QWebElement</span> secondParagraph <span class="operator">=</span> firstParagraph<span class="operator">.</span>nextSibling();
</pre>
<p>Individual elements can be inspected or changed using methods
such as <a href="qwebelement.html#attribute">attribute</a>() or
<a href="qwebelement.html#setAttribute">setAttribute</a>(). For
examle, to capture the user's input in a text field for later use
(auto-completion), a browser could do something like this:</p>
<pre class="cpp">
<span class="type">QWebElement</span> firstTextInput <span class="operator">=</span> document<span class="operator">.</span>findFirst(<span class="string">"input[type=text]"</span>);
<span class="type"><a href="qstring.html">QString</a></span> storedText <span class="operator">=</span> firstTextInput<span class="operator">.</span>attribute(<span class="string">"value"</span>);
</pre>
<p>When the same page is later revisited, the browser can fill in
the text field automatically by modifying the value attribute of
the input element:</p>
<pre class="cpp">
<span class="type">QWebElement</span> firstTextInput <span class="operator">=</span> document<span class="operator">.</span>findFirst(<span class="string">"input[type=text]"</span>);
textInput<span class="operator">.</span>setAttribute(<span class="string">"value"</span><span class="operator">,</span> storedText);
</pre>
<p>Another use case is to emulate a click event on an element. The
following code snippet demonstrates how to call the JavaScript DOM
method click() of a submit button:</p>
<pre class="cpp">
<span class="type">QWebElement</span> document <span class="operator">=</span> frame<span class="operator">-</span><span class="operator">></span>documentElement();
<span class="comment">/* Assume that the document has the following structure:
<form name="myform" action="submit_form.asp" method="get">
<input type="text" name="myfield">
<input type="submit" value="Submit">
</form>
*/</span>
<span class="type">QWebElement</span> button <span class="operator">=</span> document<span class="operator">.</span>findFirst(<span class="string">"input[type=submit]"</span>);
button<span class="operator">.</span>evaluateJavaScript(<span class="string">"this.click()"</span>);
</pre>
<p>The underlying content of QWebElement is explicitly shared.
Creating a copy of a QWebElement does not create a copy of the
content. Instead, both instances point to the same element.</p>
<p>The contents of child elements can be converted to plain text
with <a href="qwebelement.html#toPlainText">toPlainText</a>(); to
XHTML using <a href="qwebelement.html#toInnerXml">toInnerXml</a>().
To include the element's tag in the output, use <a href="qwebelement.html#toOuterXml">toOuterXml</a>().</p>
<p>It is possible to replace the contents of child elements using
<a href="qwebelement.html#setPlainText">setPlainText</a>() and
<a href="qwebelement.html#setInnerXml">setInnerXml</a>(). To
replace the element itself and its contents, use <a href="qwebelement.html#setOuterXml">setOuterXml</a>().</p>
<a id="examples" name="examples" />
<h3>Examples</h3>
<p>The <a href="webkit-domtraversal.html">DOM Traversal Example</a>
shows one way to traverse documents in a running example.</p>
<p>The <a href="webkit-simpleselector.html">Simple Selector
Example</a> can be used to experiment with the searching features
of this class and provides sample code you can start working
with.</p>
<hr /><h2>Type Documentation</h2><h3 class="fn"><a name="StyleResolveStrategy-enum" />QWebElement.StyleResolveStrategy</h3><p>This enum describes how <a href="qwebelement.html">QWebElement</a>'s styleProperty resolves the
given property name.</p>
<table class="valuelist">
<tr class="odd" valign="top">
<th class="tblConst">Constant</th>
<th class="tblval">Value</th>
<th class="tbldscr">Description</th>
</tr>
<tr>
<td class="topAlign"><tt>QWebElement.InlineStyle</tt></td>
<td class="topAlign"><tt>0</tt></td>
<td class="topAlign">Return the property value as it is defined in
the element, without respecting style inheritance and other CSS
rules.</td>
</tr>
<tr>
<td class="topAlign"><tt>QWebElement.CascadedStyle</tt></td>
<td class="topAlign"><tt>1</tt></td>
<td class="topAlign">The property's value is determined using the
inheritance and importance rules defined in the document's
stylesheet.</td>
</tr>
<tr>
<td class="topAlign"><tt>QWebElement.ComputedStyle</tt></td>
<td class="topAlign"><tt>2</tt></td>
<td class="topAlign">The property's value is the absolute value of
the style property resolved from the environment.</td>
</tr>
</table>
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QWebElement" />QWebElement.__init__ (<i>self</i>)</h3><p>Constructs a null web element.</p>
<h3 class="fn"><a name="QWebElement-2" />QWebElement.__init__ (<i>self</i>, <a href="qwebelement.html">QWebElement</a>)</h3><p>Constructs a copy of <i>other</i>.</p>
<h3 class="fn"><a name="addClass" />QWebElement.addClass (<i>self</i>, QString <i>name</i>)</h3><p>Adds the specified class with the given <i>name</i> to the
element.</p>
<h3 class="fn"><a name="appendInside" />QWebElement.appendInside (<i>self</i>, QString <i>markup</i>)</h3><p>Appends the result of parsing <i>markup</i> as the element's
last child.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#prependInside">prependInside</a>(), <a href="qwebelement.html#prependOutside">prependOutside</a>(), and
<a href="qwebelement.html#appendOutside">appendOutside</a>().</p>
<h3 class="fn"><a name="appendInside-2" />QWebElement.appendInside (<i>self</i>, <a href="qwebelement.html">QWebElement</a> <i>element</i>)</h3><p>Appends the given <i>element</i> as the element's last
child.</p>
<p>If <i>element</i> is the child of another element, it is
re-parented to this element. If <i>element</i> is a child of this
element, then its position in the list of children is changed.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#prependInside">prependInside</a>(), <a href="qwebelement.html#prependOutside">prependOutside</a>(), and
<a href="qwebelement.html#appendOutside">appendOutside</a>().</p>
<h3 class="fn"><a name="appendOutside" />QWebElement.appendOutside (<i>self</i>, QString <i>markup</i>)</h3><p>Inserts the result of parsing <i>markup</i> after this
element.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependInside">prependInside</a>(), and <a href="qwebelement.html#prependOutside">prependOutside</a>().</p>
<h3 class="fn"><a name="appendOutside-2" />QWebElement.appendOutside (<i>self</i>, <a href="qwebelement.html">QWebElement</a> <i>element</i>)</h3><p>Inserts the given <i>element</i> after this element.</p>
<p>If <i>element</i> is the child of another element, it is
re-parented to the parent of this element.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependInside">prependInside</a>(), and <a href="qwebelement.html#prependOutside">prependOutside</a>().</p>
<h3 class="fn"><a name="attribute" />QString QWebElement.attribute (<i>self</i>, QString <i>name</i>, QString <i>defaultValue</i> = '')</h3><p>Returns the attribute with the given <i>name</i>. If the
attribute does not exist, <i>defaultValue</i> is returned.</p>
<p><b>See also</b> <a href="qwebelement.html#setAttribute">setAttribute</a>(), <a href="qwebelement.html#setAttributeNS">setAttributeNS</a>(), and
<a href="qwebelement.html#attributeNS">attributeNS</a>().</p>
<h3 class="fn"><a name="attributeNames" />QStringList QWebElement.attributeNames (<i>self</i>, QString <i>namespaceUri</i> = '')</h3><p>Return the list of attributes for the namespace given as
<i>namespaceUri</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#attribute">attribute</a>() and <a href="qwebelement.html#setAttribute">setAttribute</a>().</p>
<h3 class="fn"><a name="attributeNS" />QString QWebElement.attributeNS (<i>self</i>, QString <i>namespaceUri</i>, QString <i>name</i>, QString <i>defaultValue</i> = '')</h3><p>Returns the attribute with the given <i>name</i> in
<i>namespaceUri</i>. If the attribute does not exist,
<i>defaultValue</i> is returned.</p>
<p><b>See also</b> <a href="qwebelement.html#setAttributeNS">setAttributeNS</a>(), <a href="qwebelement.html#setAttribute">setAttribute</a>(), and <a href="qwebelement.html#attribute">attribute</a>().</p>
<h3 class="fn"><a name="classes" />QStringList QWebElement.classes (<i>self</i>)</h3><p>Returns the list of classes of this element.</p>
<h3 class="fn"><a name="clone" /><a href="qwebelement.html">QWebElement</a> QWebElement.clone (<i>self</i>)</h3><p>Returns a clone of this element.</p>
<p>The clone may be inserted at any point in the document.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependInside">prependInside</a>(), <a href="qwebelement.html#prependOutside">prependOutside</a>(), and
<a href="qwebelement.html#appendOutside">appendOutside</a>().</p>
<h3 class="fn"><a name="document" /><a href="qwebelement.html">QWebElement</a> QWebElement.document (<i>self</i>)</h3><p>Returns the document which this element belongs to.</p>
<h3 class="fn"><a name="encloseContentsWith" />QWebElement.encloseContentsWith (<i>self</i>, <a href="qwebelement.html">QWebElement</a> <i>element</i>)</h3><p>Encloses the contents of this element with <i>element</i>. This
element becomes the child of the deepest descendant within
<i>element</i>.</p>
<p>### illustration</p>
<p><b>See also</b> <a href="qwebelement.html#encloseWith">encloseWith</a>().</p>
<h3 class="fn"><a name="encloseContentsWith-2" />QWebElement.encloseContentsWith (<i>self</i>, QString <i>markup</i>)</h3><p>Encloses the contents of this element with the result of parsing
<i>markup</i>. This element becomes the child of the deepest
descendant within <i>markup</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#encloseWith">encloseWith</a>().</p>
<h3 class="fn"><a name="encloseWith" />QWebElement.encloseWith (<i>self</i>, QString <i>markup</i>)</h3><p>Encloses this element with the result of parsing <i>markup</i>.
This element becomes the child of the deepest descendant within
<i>markup</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#replace">replace</a>().</p>
<h3 class="fn"><a name="encloseWith-2" />QWebElement.encloseWith (<i>self</i>, <a href="qwebelement.html">QWebElement</a> <i>element</i>)</h3><p>Encloses this element with <i>element</i>. This element becomes
the child of the deepest descendant within <i>element</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#replace">replace</a>().</p>
<h3 class="fn"><a name="evaluateJavaScript" />QVariant QWebElement.evaluateJavaScript (<i>self</i>, QString <i>scriptSource</i>)</h3><p>Executes <i>scriptSource</i> with this element as <tt>this</tt>
object.</p>
<h3 class="fn"><a name="findAll" /><a href="qwebelementcollection.html">QWebElementCollection</a> QWebElement.findAll (<i>self</i>, QString <i>selectorQuery</i>)</h3><p>Returns a new list of child elements matching the given CSS
selector <i>selectorQuery</i>. If there are no matching elements,
an empty list is returned.</p>
<p><a href="http://www.w3.org/TR/REC-CSS2/selector.html#q1">Standard CSS2
selector</a> syntax is used for the query.</p>
<p><b>Note:</b> This search is performed recursively.</p>
<p><b>See also</b> <a href="qwebelement.html#findFirst">findFirst</a>().</p>
<h3 class="fn"><a name="findFirst" /><a href="qwebelement.html">QWebElement</a> QWebElement.findFirst (<i>self</i>, QString <i>selectorQuery</i>)</h3><p>Returns the first child element that matches the given CSS
selector <i>selectorQuery</i>.</p>
<p><a href="http://www.w3.org/TR/REC-CSS2/selector.html#q1">Standard CSS2
selector</a> syntax is used for the query.</p>
<p><b>Note:</b> This search is performed recursively.</p>
<p><b>See also</b> <a href="qwebelement.html#findAll">findAll</a>().</p>
<h3 class="fn"><a name="firstChild" /><a href="qwebelement.html">QWebElement</a> QWebElement.firstChild (<i>self</i>)</h3><p>Returns the element's first child.</p>
<p><b>See also</b> <a href="qwebelement.html#lastChild">lastChild</a>(), <a href="qwebelement.html#previousSibling">previousSibling</a>(), and
<a href="qwebelement.html#nextSibling">nextSibling</a>().</p>
<h3 class="fn"><a name="geometry" /><a href="qrect.html">QRect</a> QWebElement.geometry (<i>self</i>)</h3><p>Returns the geometry of this element, relative to its containing
frame.</p>
<p><b>See also</b> <a href="qwebelement.html#tagName">tagName</a>().</p>
<h3 class="fn"><a name="hasAttribute" />bool QWebElement.hasAttribute (<i>self</i>, QString <i>name</i>)</h3><p>Returns true if this element has an attribute with the given
<i>name</i>; otherwise returns false.</p>
<p><b>See also</b> <a href="qwebelement.html#attribute">attribute</a>() and <a href="qwebelement.html#setAttribute">setAttribute</a>().</p>
<h3 class="fn"><a name="hasAttributeNS" />bool QWebElement.hasAttributeNS (<i>self</i>, QString <i>namespaceUri</i>, QString <i>name</i>)</h3><p>Returns true if this element has an attribute with the given
<i>name</i>, in <i>namespaceUri</i>; otherwise returns false.</p>
<p><b>See also</b> <a href="qwebelement.html#attributeNS">attributeNS</a>() and <a href="qwebelement.html#setAttributeNS">setAttributeNS</a>().</p>
<h3 class="fn"><a name="hasAttributes" />bool QWebElement.hasAttributes (<i>self</i>)</h3><p>Returns true if the element has any attributes defined;
otherwise returns false;</p>
<p><b>See also</b> <a href="qwebelement.html#attribute">attribute</a>() and <a href="qwebelement.html#setAttribute">setAttribute</a>().</p>
<h3 class="fn"><a name="hasClass" />bool QWebElement.hasClass (<i>self</i>, QString <i>name</i>)</h3><p>Returns true if this element has a class with the given
<i>name</i>; otherwise returns false.</p>
<h3 class="fn"><a name="hasFocus" />bool QWebElement.hasFocus (<i>self</i>)</h3><p>Returns true if the element has keyboard input focus; otherwise,
returns false</p>
<p><b>See also</b> <a href="qwebelement.html#setFocus">setFocus</a>().</p>
<h3 class="fn"><a name="isNull" />bool QWebElement.isNull (<i>self</i>)</h3><p>Returns true if the element is a null element; otherwise returns
false.</p>
<h3 class="fn"><a name="lastChild" /><a href="qwebelement.html">QWebElement</a> QWebElement.lastChild (<i>self</i>)</h3><p>Returns the element's last child.</p>
<p><b>See also</b> <a href="qwebelement.html#firstChild">firstChild</a>(), <a href="qwebelement.html#previousSibling">previousSibling</a>(), and
<a href="qwebelement.html#nextSibling">nextSibling</a>().</p>
<h3 class="fn"><a name="localName" />QString QWebElement.localName (<i>self</i>)</h3><p>Returns the local name of the element. If the element does not
use namespaces, an empty string is returned.</p>
<h3 class="fn"><a name="namespaceUri" />QString QWebElement.namespaceUri (<i>self</i>)</h3><p>Returns the namespace URI of this element. If the element has no
namespace URI, an empty string is returned.</p>
<h3 class="fn"><a name="nextSibling" /><a href="qwebelement.html">QWebElement</a> QWebElement.nextSibling (<i>self</i>)</h3><p>Returns the element's next sibling.</p>
<p><b>See also</b> <a href="qwebelement.html#firstChild">firstChild</a>(), <a href="qwebelement.html#previousSibling">previousSibling</a>(), and
<a href="qwebelement.html#lastChild">lastChild</a>().</p>
<h3 class="fn"><a name="parent" /><a href="qwebelement.html">QWebElement</a> QWebElement.parent (<i>self</i>)</h3><p>Returns the parent element of this elemen. If this element is
the root document element, a null element is returned.</p>
<h3 class="fn"><a name="prefix" />QString QWebElement.prefix (<i>self</i>)</h3><p>Returns the namespace prefix of the element. If the element has
no namespace prefix, empty string is returned.</p>
<h3 class="fn"><a name="prependInside" />QWebElement.prependInside (<i>self</i>, QString <i>markup</i>)</h3><p>Prepends the result of parsing <i>markup</i> as the element's
first child.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependOutside">prependOutside</a>(), and
<a href="qwebelement.html#appendOutside">appendOutside</a>().</p>
<h3 class="fn"><a name="prependInside-2" />QWebElement.prependInside (<i>self</i>, <a href="qwebelement.html">QWebElement</a> <i>element</i>)</h3><p>Prepends <i>element</i> as the element's first child.</p>
<p>If <i>element</i> is the child of another element, it is
re-parented to this element. If <i>element</i> is a child of this
element, then its position in the list of children is changed.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependOutside">prependOutside</a>(), and
<a href="qwebelement.html#appendOutside">appendOutside</a>().</p>
<h3 class="fn"><a name="prependOutside" />QWebElement.prependOutside (<i>self</i>, QString <i>markup</i>)</h3><p>Inserts the result of parsing <i>markup</i> before this
element.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependInside">prependInside</a>(), and <a href="qwebelement.html#appendOutside">appendOutside</a>().</p>
<h3 class="fn"><a name="prependOutside-2" />QWebElement.prependOutside (<i>self</i>, <a href="qwebelement.html">QWebElement</a> <i>element</i>)</h3><p>Inserts the given <i>element</i> before this element.</p>
<p>If <i>element</i> is the child of another element, it is
re-parented to the parent of this element.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependInside">prependInside</a>(), and <a href="qwebelement.html#appendOutside">appendOutside</a>().</p>
<h3 class="fn"><a name="previousSibling" /><a href="qwebelement.html">QWebElement</a> QWebElement.previousSibling (<i>self</i>)</h3><p>Returns the element's previous sibling.</p>
<p><b>See also</b> <a href="qwebelement.html#firstChild">firstChild</a>(), <a href="qwebelement.html#nextSibling">nextSibling</a>(), and <a href="qwebelement.html#lastChild">lastChild</a>().</p>
<h3 class="fn"><a name="removeAllChildren" />QWebElement.removeAllChildren (<i>self</i>)</h3><p>Removes all children from this element.</p>
<p><b>See also</b> <a href="qwebelement.html#removeFromDocument">removeFromDocument</a>() and
<a href="qwebelement.html#takeFromDocument">takeFromDocument</a>().</p>
<h3 class="fn"><a name="removeAttribute" />QWebElement.removeAttribute (<i>self</i>, QString <i>name</i>)</h3><p>Removes the attribute with the given <i>name</i> from this
element.</p>
<p><b>See also</b> <a href="qwebelement.html#attribute">attribute</a>(), <a href="qwebelement.html#setAttribute">setAttribute</a>(), and <a href="qwebelement.html#hasAttribute">hasAttribute</a>().</p>
<h3 class="fn"><a name="removeAttributeNS" />QWebElement.removeAttributeNS (<i>self</i>, QString <i>namespaceUri</i>, QString <i>name</i>)</h3><p>Removes the attribute with the given <i>name</i>, in
<i>namespaceUri</i>, from this element.</p>
<p><b>See also</b> <a href="qwebelement.html#attributeNS">attributeNS</a>(), <a href="qwebelement.html#setAttributeNS">setAttributeNS</a>(), and
<a href="qwebelement.html#hasAttributeNS">hasAttributeNS</a>().</p>
<h3 class="fn"><a name="removeClass" />QWebElement.removeClass (<i>self</i>, QString <i>name</i>)</h3><p>Removes the specified class with the given <i>name</i> from the
element.</p>
<h3 class="fn"><a name="removeFromDocument" />QWebElement.removeFromDocument (<i>self</i>)</h3><p>Removes this element from the document and makes it a null
element.</p>
<p><b>See also</b> <a href="qwebelement.html#removeAllChildren">removeAllChildren</a>() and
<a href="qwebelement.html#takeFromDocument">takeFromDocument</a>().</p>
<h3 class="fn"><a name="render" />QWebElement.render (<i>self</i>, <a href="qpainter.html">QPainter</a> <i>painter</i>)</h3><p>Render the element into <i>painter</i> .</p>
<h3 class="fn"><a name="render-2" />QWebElement.render (<i>self</i>, <a href="qpainter.html">QPainter</a> <i>painter</i>, <a href="qrect.html">QRect</a> <i>clip</i>)</h3><p>Render the element into <i>painter</i> clipping to
<i>clip</i>.</p>
<h3 class="fn"><a name="replace" />QWebElement.replace (<i>self</i>, QString <i>markup</i>)</h3><p>Replaces this element with the result of parsing
<i>markup</i>.</p>
<p>This method will not replace the <html>, <head> or
<body> elements.</p>
<p><b>See also</b> <a href="qwebelement.html#encloseWith">encloseWith</a>().</p>
<h3 class="fn"><a name="replace-2" />QWebElement.replace (<i>self</i>, <a href="qwebelement.html">QWebElement</a> <i>element</i>)</h3><p>Replaces this element with <i>element</i>.</p>
<p>This method will not replace the <html>, <head> or
<body> elements.</p>
<p><b>See also</b> <a href="qwebelement.html#encloseWith">encloseWith</a>().</p>
<h3 class="fn"><a name="setAttribute" />QWebElement.setAttribute (<i>self</i>, QString <i>name</i>, QString <i>value</i>)</h3><p>Adds an attribute with the given <i>name</i> and <i>value</i>.
If an attribute with the same name exists, its value is replaced by
<i>value</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#attribute">attribute</a>(), <a href="qwebelement.html#attributeNS">attributeNS</a>(), and <a href="qwebelement.html#setAttributeNS">setAttributeNS</a>().</p>
<h3 class="fn"><a name="setAttributeNS" />QWebElement.setAttributeNS (<i>self</i>, QString <i>namespaceUri</i>, QString <i>name</i>, QString <i>value</i>)</h3><p>Adds an attribute with the given <i>name</i> in
<i>namespaceUri</i> with <i>value</i>. If an attribute with the
same name exists, its value is replaced by <i>value</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#attributeNS">attributeNS</a>(), <a href="qwebelement.html#attribute">attribute</a>(), and <a href="qwebelement.html#setAttribute">setAttribute</a>().</p>
<h3 class="fn"><a name="setFocus" />QWebElement.setFocus (<i>self</i>)</h3><p>Gives keyboard input focus to this element</p>
<p><b>See also</b> <a href="qwebelement.html#hasFocus">hasFocus</a>().</p>
<h3 class="fn"><a name="setInnerXml" />QWebElement.setInnerXml (<i>self</i>, QString <i>markup</i>)</h3><p>Replaces the contents of this element with <i>markup</i>. The
string may contain HTML or XML tags, which is parsed and formatted
before insertion into the document.</p>
<p><b>Note:</b> This is currently implemented for (X)HTML elements
only.</p>
<p><b>See also</b> <a href="qwebelement.html#toInnerXml">toInnerXml</a>(), <a href="qwebelement.html#toOuterXml">toOuterXml</a>(), and <a href="qwebelement.html#setOuterXml">setOuterXml</a>().</p>
<h3 class="fn"><a name="setOuterXml" />QWebElement.setOuterXml (<i>self</i>, QString <i>markup</i>)</h3><p>Replaces the contents of this element as well as its own tag
with <i>markup</i>. The string may contain HTML or XML tags, which
is parsed and formatted before insertion into the document.</p>
<p><b>Note:</b> This is currently only implemented for (X)HTML
elements.</p>
<p><b>See also</b> <a href="qwebelement.html#toOuterXml">toOuterXml</a>(), <a href="qwebelement.html#toInnerXml">toInnerXml</a>(), and <a href="qwebelement.html#setInnerXml">setInnerXml</a>().</p>
<h3 class="fn"><a name="setPlainText" />QWebElement.setPlainText (<i>self</i>, QString <i>text</i>)</h3><p>Replaces the existing content of this element with
<i>text</i>.</p>
<p>This is equivalent to setting the HTML innerText property.</p>
<p><b>See also</b> <a href="qwebelement.html#toPlainText">toPlainText</a>().</p>
<h3 class="fn"><a name="setStyleProperty" />QWebElement.setStyleProperty (<i>self</i>, QString <i>name</i>, QString <i>value</i>)</h3><p>Sets the value of the inline style with the given <i>name</i> to
<i>value</i>.</p>
<p>Setting a value, does not necessarily mean that it will become
the applied value, due to the fact that the style property's value
might have been set earlier with a higher priority in external or
embedded style declarations.</p>
<p>In order to ensure that the value will be applied, you may have
to append "!important" to the value.</p>
<p><b>See also</b> <a href="qwebelement.html#styleProperty">styleProperty</a>().</p>
<h3 class="fn"><a name="styleProperty" />QString QWebElement.styleProperty (<i>self</i>, QString <i>name</i>, <a href="qwebelement.html#StyleResolveStrategy-enum">StyleResolveStrategy</a> <i>strategy</i>)</h3><p>Returns the value of the style with the given <i>name</i> using
the specified <i>strategy</i>. If a style with <i>name</i> does not
exist, an empty string is returned.</p>
<p>In CSS, the cascading part depends on which CSS rule has
priority and is thus applied. Generally, the last defined rule has
priority. Thus, an inline style rule has priority over an embedded
block style rule, which in return has priority over an external
style rule.</p>
<p>If the "!important" declaration is set on one of those, the
declaration receives highest priority, unless other declarations
also use the "!important" declaration. Then, the last "!important"
declaration takes predecence.</p>
<p><b>See also</b> <a href="qwebelement.html#setStyleProperty">setStyleProperty</a>().</p>
<h3 class="fn"><a name="tagName" />QString QWebElement.tagName (<i>self</i>)</h3><p>Returns the tag name of this element.</p>
<p><b>See also</b> <a href="qwebelement.html#geometry">geometry</a>().</p>
<h3 class="fn"><a name="takeFromDocument" /><a href="qwebelement.html">QWebElement</a> QWebElement.takeFromDocument (<i>self</i>)</h3><p>Removes this element from the document and returns a reference
to it.</p>
<p>The element is still valid after removal, and can be inserted
into other parts of the document.</p>
<p><b>See also</b> <a href="qwebelement.html#removeAllChildren">removeAllChildren</a>() and
<a href="qwebelement.html#removeFromDocument">removeFromDocument</a>().</p>
<h3 class="fn"><a name="toggleClass" />QWebElement.toggleClass (<i>self</i>, QString <i>name</i>)</h3><p>Adds the specified class with the given <i>name</i> if it is not
present. If the class is already present, it will be removed.</p>
<h3 class="fn"><a name="toInnerXml" />QString QWebElement.toInnerXml (<i>self</i>)</h3><p>Returns the XML content between the element's start and end
tags.</p>
<p><b>Note:</b> This is currently implemented for (X)HTML elements
only.</p>
<p><b>Note:</b> The format of the markup returned will obey the
namespace of the document containing the element. This means the
return value will obey XML formatting rules, such as self-closing
tags, only if the document is 'text/xhtml+xml'.</p>
<p><b>See also</b> <a href="qwebelement.html#setInnerXml">setInnerXml</a>(), <a href="qwebelement.html#setOuterXml">setOuterXml</a>(), and <a href="qwebelement.html#toOuterXml">toOuterXml</a>().</p>
<h3 class="fn"><a name="toOuterXml" />QString QWebElement.toOuterXml (<i>self</i>)</h3><p>Returns this element converted to XML, including the start and
the end tags as well as its attributes.</p>
<p><b>Note:</b> This is currently implemented for (X)HTML elements
only.</p>
<p><b>Note:</b> The format of the markup returned will obey the
namespace of the document containing the element. This means the
return value will obey XML formatting rules, such as self-closing
tags, only if the document is 'text/xhtml+xml'.</p>
<p><b>See also</b> <a href="qwebelement.html#setOuterXml">setOuterXml</a>(), <a href="qwebelement.html#setInnerXml">setInnerXml</a>(), and <a href="qwebelement.html#toInnerXml">toInnerXml</a>().</p>
<h3 class="fn"><a name="toPlainText" />QString QWebElement.toPlainText (<i>self</i>)</h3><p>Returns the text between the start and the end tag of this
element.</p>
<p>This is equivalent to reading the HTML innerText property.</p>
<p><b>See also</b> <a href="qwebelement.html#setPlainText">setPlainText</a>().</p>
<h3 class="fn"><a name="webFrame" /><a href="qwebframe.html">QWebFrame</a> QWebElement.webFrame (<i>self</i>)</h3><p>Returns the web frame which this element is a part of. If the
element is a null element, null is returned.</p>
<h3 class="fn"><a name="__eq__" />bool QWebElement.__eq__ (<i>self</i>, <a href="qwebelement.html">QWebElement</a> <i>o</i>)</h3><h3 class="fn"><a name="__ne__" />bool QWebElement.__ne__ (<i>self</i>, <a href="qwebelement.html">QWebElement</a> <i>o</i>)</h3><address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt 4.12.1 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.qt.io">The Qt Company</a> 2015</td><td align="right" width="25%">Qt 4.8.7</td></tr></table></div></address></body></html>
|
