<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qwebelement.cpp -->
<title>Qt 4.8: QWebElement Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtwebkit.html">QtWebKit</a></li>
<li>QWebElement</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
<li class="level2"><a href="#examples">Examples</a></li>
</ul>
</div>
<h1 class="title">QWebElement Class Reference</h1>
<!-- $$$QWebElement-brief -->
<p>The QWebElement class provides convenient access to DOM elements in a <a href="qwebframe.html">QWebFrame</a>. <a href="#details">More...</a></p>
<!-- @@@QWebElement -->
<pre class="cpp"> <span class="preprocessor">#include <QWebElement></span></pre><p>This class was introduced in Qt 4.6.</p>
<ul>
<li><a href="qwebelement-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#StyleResolveStrategy-enum">StyleResolveStrategy</a></b> { InlineStyle, CascadedStyle, ComputedStyle }</td></tr>
</table>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#QWebElement">QWebElement</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#QWebElement-2">QWebElement</a></b> ( const QWebElement & <i>other</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#dtor.QWebElement">~QWebElement</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#addClass">addClass</a></b> ( const QString & <i>name</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#appendInside">appendInside</a></b> ( const QString & <i>markup</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#appendInside-2">appendInside</a></b> ( const QWebElement & <i>element</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#appendOutside">appendOutside</a></b> ( const QString & <i>markup</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#appendOutside-2">appendOutside</a></b> ( const QWebElement & <i>element</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#attribute">attribute</a></b> ( const QString & <i>name</i>, const QString & <i>defaultValue</i> = QString() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#attributeNS">attributeNS</a></b> ( const QString & <i>namespaceUri</i>, const QString & <i>name</i>, const QString & <i>defaultValue</i> = QString() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#attributeNames">attributeNames</a></b> ( const QString & <i>namespaceUri</i> = QString() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#classes">classes</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElement </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#clone">clone</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElement </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#document">document</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#encloseContentsWith">encloseContentsWith</a></b> ( const QWebElement & <i>element</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#encloseContentsWith-2">encloseContentsWith</a></b> ( const QString & <i>markup</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#encloseWith">encloseWith</a></b> ( const QString & <i>markup</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#encloseWith-2">encloseWith</a></b> ( const QWebElement & <i>element</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QVariant </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#evaluateJavaScript">evaluateJavaScript</a></b> ( const QString & <i>scriptSource</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElementCollection </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#findAll">findAll</a></b> ( const QString & <i>selectorQuery</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElement </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#findFirst">findFirst</a></b> ( const QString & <i>selectorQuery</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElement </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#firstChild">firstChild</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRect </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#geometry">geometry</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#hasAttribute">hasAttribute</a></b> ( const QString & <i>name</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#hasAttributeNS">hasAttributeNS</a></b> ( const QString & <i>namespaceUri</i>, const QString & <i>name</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#hasAttributes">hasAttributes</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#hasClass">hasClass</a></b> ( const QString & <i>name</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#hasFocus">hasFocus</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#isNull">isNull</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElement </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#lastChild">lastChild</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#localName">localName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#namespaceUrix">namespaceUri</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElement </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#nextSibling">nextSibling</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElement </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#parent">parent</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#prefix">prefix</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#prependInside">prependInside</a></b> ( const QString & <i>markup</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#prependInside-2">prependInside</a></b> ( const QWebElement & <i>element</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#prependOutside">prependOutside</a></b> ( const QString & <i>markup</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#prependOutside-2">prependOutside</a></b> ( const QWebElement & <i>element</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElement </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#previousSibling">previousSibling</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#removeAllChildren">removeAllChildren</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#removeAttribute">removeAttribute</a></b> ( const QString & <i>name</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#removeAttributeNS">removeAttributeNS</a></b> ( const QString & <i>namespaceUri</i>, const QString & <i>name</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#removeClass">removeClass</a></b> ( const QString & <i>name</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#removeFromDocument">removeFromDocument</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#render">render</a></b> ( QPainter * <i>painter</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#render-2">render</a></b> ( QPainter * <i>painter</i>, const QRect & <i>clip</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#replace">replace</a></b> ( const QString & <i>markup</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#replace-2">replace</a></b> ( const QWebElement & <i>element</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#setAttribute">setAttribute</a></b> ( const QString & <i>name</i>, const QString & <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#setAttributeNS">setAttributeNS</a></b> ( const QString & <i>namespaceUri</i>, const QString & <i>name</i>, const QString & <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#setFocus">setFocus</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#setInnerXml">setInnerXml</a></b> ( const QString & <i>markup</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#setOuterXml">setOuterXml</a></b> ( const QString & <i>markup</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#setPlainText">setPlainText</a></b> ( const QString & <i>text</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#setStyleProperty">setStyleProperty</a></b> ( const QString & <i>name</i>, const QString & <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#styleProperty">styleProperty</a></b> ( const QString & <i>name</i>, StyleResolveStrategy <i>strategy</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#tagName">tagName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElement & </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#takeFromDocument">takeFromDocument</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#toInnerXml">toInnerXml</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#toOuterXml">toOuterXml</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#toPlainText">toPlainText</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#toggleClass">toggleClass</a></b> ( const QString & <i>name</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebFrame * </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#webFrame">webFrame</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#operator-not-eq">operator!=</a></b> ( const QWebElement & <i>o</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QWebElement & </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#operator-eq">operator=</a></b> ( const QWebElement & <i>other</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qwebelement.html#operator-eq-eq">operator==</a></b> ( const QWebElement & <i>o</i> ) const</td></tr>
</table>
<a name="details"></a>
<!-- $$$QWebElement-description -->
<div class="descr">
<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 name="examples"></a>
<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>
</div>
<!-- @@@QWebElement -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$StyleResolveStrategy$$$InlineStyle$$$CascadedStyle$$$ComputedStyle -->
<h3 class="fn"><a name="StyleResolveStrategy-enum"></a>enum QWebElement::<span class="name">StyleResolveStrategy</span></h3>
<p>This enum describes how <a href="qwebelement.html">QWebElement</a>'s styleProperty resolves the given property name.</p>
<table class="valuelist"><tr valign="top" class="odd"><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>
<!-- @@@StyleResolveStrategy -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QWebElement[overload1]$$$QWebElement -->
<h3 class="fn"><a name="QWebElement"></a>QWebElement::<span class="name">QWebElement</span> ()</h3>
<p>Constructs a null web element.</p>
<!-- @@@QWebElement -->
<!-- $$$QWebElement$$$QWebElementconstQWebElement& -->
<h3 class="fn"><a name="QWebElement-2"></a>QWebElement::<span class="name">QWebElement</span> ( const <span class="type">QWebElement</span> & <i>other</i> )</h3>
<p>Constructs a copy of <i>other</i>.</p>
<!-- @@@QWebElement -->
<!-- $$$~QWebElement[overload1]$$$~QWebElement -->
<h3 class="fn"><a name="dtor.QWebElement"></a>QWebElement::<span class="name">~QWebElement</span> ()</h3>
<p>Destroys the element. However, the underlying DOM element is not destroyed.</p>
<!-- @@@~QWebElement -->
<!-- $$$addClass[overload1]$$$addClassconstQString& -->
<h3 class="fn"><a name="addClass"></a><span class="type">void</span> QWebElement::<span class="name">addClass</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i> )</h3>
<p>Adds the specified class with the given <i>name</i> to the element.</p>
<!-- @@@addClass -->
<!-- $$$appendInside[overload1]$$$appendInsideconstQString& -->
<h3 class="fn"><a name="appendInside"></a><span class="type">void</span> QWebElement::<span class="name">appendInside</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@appendInside -->
<!-- $$$appendInside$$$appendInsideconstQWebElement& -->
<h3 class="fn"><a name="appendInside-2"></a><span class="type">void</span> QWebElement::<span class="name">appendInside</span> ( const <span class="type">QWebElement</span> & <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>
<!-- @@@appendInside -->
<!-- $$$appendOutside[overload1]$$$appendOutsideconstQString& -->
<h3 class="fn"><a name="appendOutside"></a><span class="type">void</span> QWebElement::<span class="name">appendOutside</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@appendOutside -->
<!-- $$$appendOutside$$$appendOutsideconstQWebElement& -->
<h3 class="fn"><a name="appendOutside-2"></a><span class="type">void</span> QWebElement::<span class="name">appendOutside</span> ( const <span class="type">QWebElement</span> & <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>
<!-- @@@appendOutside -->
<!-- $$$attribute[overload1]$$$attributeconstQString&constQString& -->
<h3 class="fn"><a name="attribute"></a><span class="type"><a href="qstring.html">QString</a></span> QWebElement::<span class="name">attribute</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>defaultValue</i> = QString() ) const</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>
<!-- @@@attribute -->
<!-- $$$attributeNS[overload1]$$$attributeNSconstQString&constQString&constQString& -->
<h3 class="fn"><a name="attributeNS"></a><span class="type"><a href="qstring.html">QString</a></span> QWebElement::<span class="name">attributeNS</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>namespaceUri</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>defaultValue</i> = QString() ) const</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>
<!-- @@@attributeNS -->
<!-- $$$attributeNames[overload1]$$$attributeNamesconstQString& -->
<h3 class="fn"><a name="attributeNames"></a><span class="type"><a href="qstringlist.html">QStringList</a></span> QWebElement::<span class="name">attributeNames</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>namespaceUri</i> = QString() ) const</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>
<!-- @@@attributeNames -->
<!-- $$$classes[overload1]$$$classes -->
<h3 class="fn"><a name="classes"></a><span class="type"><a href="qstringlist.html">QStringList</a></span> QWebElement::<span class="name">classes</span> () const</h3>
<p>Returns the list of classes of this element.</p>
<!-- @@@classes -->
<!-- $$$clone[overload1]$$$clone -->
<h3 class="fn"><a name="clone"></a><span class="type">QWebElement</span> QWebElement::<span class="name">clone</span> () const</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>
<!-- @@@clone -->
<!-- $$$document[overload1]$$$document -->
<h3 class="fn"><a name="document"></a><span class="type">QWebElement</span> QWebElement::<span class="name">document</span> () const</h3>
<p>Returns the document which this element belongs to.</p>
<!-- @@@document -->
<!-- $$$encloseContentsWith[overload1]$$$encloseContentsWithconstQWebElement& -->
<h3 class="fn"><a name="encloseContentsWith"></a><span class="type">void</span> QWebElement::<span class="name">encloseContentsWith</span> ( const <span class="type">QWebElement</span> & <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>
<!-- @@@encloseContentsWith -->
<!-- $$$encloseContentsWith$$$encloseContentsWithconstQString& -->
<h3 class="fn"><a name="encloseContentsWith-2"></a><span class="type">void</span> QWebElement::<span class="name">encloseContentsWith</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@encloseContentsWith -->
<!-- $$$encloseWith[overload1]$$$encloseWithconstQString& -->
<h3 class="fn"><a name="encloseWith"></a><span class="type">void</span> QWebElement::<span class="name">encloseWith</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@encloseWith -->
<!-- $$$encloseWith$$$encloseWithconstQWebElement& -->
<h3 class="fn"><a name="encloseWith-2"></a><span class="type">void</span> QWebElement::<span class="name">encloseWith</span> ( const <span class="type">QWebElement</span> & <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>
<!-- @@@encloseWith -->
<!-- $$$evaluateJavaScript[overload1]$$$evaluateJavaScriptconstQString& -->
<h3 class="fn"><a name="evaluateJavaScript"></a><span class="type"><a href="qvariant.html">QVariant</a></span> QWebElement::<span class="name">evaluateJavaScript</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>scriptSource</i> )</h3>
<p>Executes <i>scriptSource</i> with this element as <tt>this</tt> object.</p>
<!-- @@@evaluateJavaScript -->
<!-- $$$findAll[overload1]$$$findAllconstQString& -->
<h3 class="fn"><a name="findAll"></a><span class="type"><a href="qwebelementcollection.html">QWebElementCollection</a></span> QWebElement::<span class="name">findAll</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>selectorQuery</i> ) const</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>
<!-- @@@findAll -->
<!-- $$$findFirst[overload1]$$$findFirstconstQString& -->
<h3 class="fn"><a name="findFirst"></a><span class="type">QWebElement</span> QWebElement::<span class="name">findFirst</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>selectorQuery</i> ) const</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>
<!-- @@@findFirst -->
<!-- $$$firstChild[overload1]$$$firstChild -->
<h3 class="fn"><a name="firstChild"></a><span class="type">QWebElement</span> QWebElement::<span class="name">firstChild</span> () const</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>
<!-- @@@firstChild -->
<!-- $$$geometry[overload1]$$$geometry -->
<h3 class="fn"><a name="geometry"></a><span class="type"><a href="qrect.html">QRect</a></span> QWebElement::<span class="name">geometry</span> () const</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>
<!-- @@@geometry -->
<!-- $$$hasAttribute[overload1]$$$hasAttributeconstQString& -->
<h3 class="fn"><a name="hasAttribute"></a><span class="type">bool</span> QWebElement::<span class="name">hasAttribute</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i> ) const</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>
<!-- @@@hasAttribute -->
<!-- $$$hasAttributeNS[overload1]$$$hasAttributeNSconstQString&constQString& -->
<h3 class="fn"><a name="hasAttributeNS"></a><span class="type">bool</span> QWebElement::<span class="name">hasAttributeNS</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>namespaceUri</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i> ) const</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>
<!-- @@@hasAttributeNS -->
<!-- $$$hasAttributes[overload1]$$$hasAttributes -->
<h3 class="fn"><a name="hasAttributes"></a><span class="type">bool</span> QWebElement::<span class="name">hasAttributes</span> () const</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>
<!-- @@@hasAttributes -->
<!-- $$$hasClass[overload1]$$$hasClassconstQString& -->
<h3 class="fn"><a name="hasClass"></a><span class="type">bool</span> QWebElement::<span class="name">hasClass</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i> ) const</h3>
<p>Returns true if this element has a class with the given <i>name</i>; otherwise returns false.</p>
<!-- @@@hasClass -->
<!-- $$$hasFocus[overload1]$$$hasFocus -->
<h3 class="fn"><a name="hasFocus"></a><span class="type">bool</span> QWebElement::<span class="name">hasFocus</span> () const</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>
<!-- @@@hasFocus -->
<!-- $$$isNull[overload1]$$$isNull -->
<h3 class="fn"><a name="isNull"></a><span class="type">bool</span> QWebElement::<span class="name">isNull</span> () const</h3>
<p>Returns true if the element is a null element; otherwise returns false.</p>
<!-- @@@isNull -->
<!-- $$$lastChild[overload1]$$$lastChild -->
<h3 class="fn"><a name="lastChild"></a><span class="type">QWebElement</span> QWebElement::<span class="name">lastChild</span> () const</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>
<!-- @@@lastChild -->
<!-- $$$localName[overload1]$$$localName -->
<h3 class="fn"><a name="localName"></a><span class="type"><a href="qstring.html">QString</a></span> QWebElement::<span class="name">localName</span> () const</h3>
<p>Returns the local name of the element. If the element does not use namespaces, an empty string is returned.</p>
<!-- @@@localName -->
<!-- $$$namespaceUri[overload1]$$$namespaceUri -->
<h3 class="fn"><a name="namespaceUrix"></a><span class="type"><a href="qstring.html">QString</a></span> QWebElement::<span class="name">namespaceUri</span> () const</h3>
<p>Returns the namespace URI of this element. If the element has no namespace URI, an empty string is returned.</p>
<!-- @@@namespaceUri -->
<!-- $$$nextSibling[overload1]$$$nextSibling -->
<h3 class="fn"><a name="nextSibling"></a><span class="type">QWebElement</span> QWebElement::<span class="name">nextSibling</span> () const</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>
<!-- @@@nextSibling -->
<!-- $$$parent[overload1]$$$parent -->
<h3 class="fn"><a name="parent"></a><span class="type">QWebElement</span> QWebElement::<span class="name">parent</span> () const</h3>
<p>Returns the parent element of this elemen. If this element is the root document element, a null element is returned.</p>
<!-- @@@parent -->
<!-- $$$prefix[overload1]$$$prefix -->
<h3 class="fn"><a name="prefix"></a><span class="type"><a href="qstring.html">QString</a></span> QWebElement::<span class="name">prefix</span> () const</h3>
<p>Returns the namespace prefix of the element. If the element has no namespace prefix, empty string is returned.</p>
<!-- @@@prefix -->
<!-- $$$prependInside[overload1]$$$prependInsideconstQString& -->
<h3 class="fn"><a name="prependInside"></a><span class="type">void</span> QWebElement::<span class="name">prependInside</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@prependInside -->
<!-- $$$prependInside$$$prependInsideconstQWebElement& -->
<h3 class="fn"><a name="prependInside-2"></a><span class="type">void</span> QWebElement::<span class="name">prependInside</span> ( const <span class="type">QWebElement</span> & <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>
<!-- @@@prependInside -->
<!-- $$$prependOutside[overload1]$$$prependOutsideconstQString& -->
<h3 class="fn"><a name="prependOutside"></a><span class="type">void</span> QWebElement::<span class="name">prependOutside</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@prependOutside -->
<!-- $$$prependOutside$$$prependOutsideconstQWebElement& -->
<h3 class="fn"><a name="prependOutside-2"></a><span class="type">void</span> QWebElement::<span class="name">prependOutside</span> ( const <span class="type">QWebElement</span> & <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>
<!-- @@@prependOutside -->
<!-- $$$previousSibling[overload1]$$$previousSibling -->
<h3 class="fn"><a name="previousSibling"></a><span class="type">QWebElement</span> QWebElement::<span class="name">previousSibling</span> () const</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>
<!-- @@@previousSibling -->
<!-- $$$removeAllChildren[overload1]$$$removeAllChildren -->
<h3 class="fn"><a name="removeAllChildren"></a><span class="type">void</span> QWebElement::<span class="name">removeAllChildren</span> ()</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>
<!-- @@@removeAllChildren -->
<!-- $$$removeAttribute[overload1]$$$removeAttributeconstQString& -->
<h3 class="fn"><a name="removeAttribute"></a><span class="type">void</span> QWebElement::<span class="name">removeAttribute</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@removeAttribute -->
<!-- $$$removeAttributeNS[overload1]$$$removeAttributeNSconstQString&constQString& -->
<h3 class="fn"><a name="removeAttributeNS"></a><span class="type">void</span> QWebElement::<span class="name">removeAttributeNS</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>namespaceUri</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@removeAttributeNS -->
<!-- $$$removeClass[overload1]$$$removeClassconstQString& -->
<h3 class="fn"><a name="removeClass"></a><span class="type">void</span> QWebElement::<span class="name">removeClass</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i> )</h3>
<p>Removes the specified class with the given <i>name</i> from the element.</p>
<!-- @@@removeClass -->
<!-- $$$removeFromDocument[overload1]$$$removeFromDocument -->
<h3 class="fn"><a name="removeFromDocument"></a><span class="type">void</span> QWebElement::<span class="name">removeFromDocument</span> ()</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>
<!-- @@@removeFromDocument -->
<!-- $$$render[overload1]$$$renderQPainter* -->
<h3 class="fn"><a name="render"></a><span class="type">void</span> QWebElement::<span class="name">render</span> ( <span class="type"><a href="qpainter.html">QPainter</a></span> * <i>painter</i> )</h3>
<p>Render the element into <i>painter</i> .</p>
<!-- @@@render -->
<!-- $$$render$$$renderQPainter*constQRect& -->
<h3 class="fn"><a name="render-2"></a><span class="type">void</span> QWebElement::<span class="name">render</span> ( <span class="type"><a href="qpainter.html">QPainter</a></span> * <i>painter</i>, const <span class="type"><a href="qrect.html">QRect</a></span> & <i>clip</i> )</h3>
<p>Render the element into <i>painter</i> clipping to <i>clip</i>.</p>
<!-- @@@render -->
<!-- $$$replace[overload1]$$$replaceconstQString& -->
<h3 class="fn"><a name="replace"></a><span class="type">void</span> QWebElement::<span class="name">replace</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@replace -->
<!-- $$$replace$$$replaceconstQWebElement& -->
<h3 class="fn"><a name="replace-2"></a><span class="type">void</span> QWebElement::<span class="name">replace</span> ( const <span class="type">QWebElement</span> & <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>
<!-- @@@replace -->
<!-- $$$setAttribute[overload1]$$$setAttributeconstQString&constQString& -->
<h3 class="fn"><a name="setAttribute"></a><span class="type">void</span> QWebElement::<span class="name">setAttribute</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@setAttribute -->
<!-- $$$setAttributeNS[overload1]$$$setAttributeNSconstQString&constQString&constQString& -->
<h3 class="fn"><a name="setAttributeNS"></a><span class="type">void</span> QWebElement::<span class="name">setAttributeNS</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>namespaceUri</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@setAttributeNS -->
<!-- $$$setFocus[overload1]$$$setFocus -->
<h3 class="fn"><a name="setFocus"></a><span class="type">void</span> QWebElement::<span class="name">setFocus</span> ()</h3>
<p>Gives keyboard input focus to this element</p>
<p><b>See also </b><a href="qwebelement.html#hasFocus">hasFocus</a>().</p>
<!-- @@@setFocus -->
<!-- $$$setInnerXml[overload1]$$$setInnerXmlconstQString& -->
<h3 class="fn"><a name="setInnerXml"></a><span class="type">void</span> QWebElement::<span class="name">setInnerXml</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@setInnerXml -->
<!-- $$$setOuterXml[overload1]$$$setOuterXmlconstQString& -->
<h3 class="fn"><a name="setOuterXml"></a><span class="type">void</span> QWebElement::<span class="name">setOuterXml</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@setOuterXml -->
<!-- $$$setPlainText[overload1]$$$setPlainTextconstQString& -->
<h3 class="fn"><a name="setPlainText"></a><span class="type">void</span> QWebElement::<span class="name">setPlainText</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@setPlainText -->
<!-- $$$setStyleProperty[overload1]$$$setStylePropertyconstQString&constQString& -->
<h3 class="fn"><a name="setStyleProperty"></a><span class="type">void</span> QWebElement::<span class="name">setStyleProperty</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@setStyleProperty -->
<!-- $$$styleProperty[overload1]$$$stylePropertyconstQString&StyleResolveStrategy -->
<h3 class="fn"><a name="styleProperty"></a><span class="type"><a href="qstring.html">QString</a></span> QWebElement::<span class="name">styleProperty</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>name</i>, <span class="type"><a href="qwebelement.html#StyleResolveStrategy-enum">StyleResolveStrategy</a></span> <i>strategy</i> ) const</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>
<!-- @@@styleProperty -->
<!-- $$$tagName[overload1]$$$tagName -->
<h3 class="fn"><a name="tagName"></a><span class="type"><a href="qstring.html">QString</a></span> QWebElement::<span class="name">tagName</span> () const</h3>
<p>Returns the tag name of this element.</p>
<p><b>See also </b><a href="qwebelement.html#geometry">geometry</a>().</p>
<!-- @@@tagName -->
<!-- $$$takeFromDocument[overload1]$$$takeFromDocument -->
<h3 class="fn"><a name="takeFromDocument"></a><span class="type">QWebElement</span> & QWebElement::<span class="name">takeFromDocument</span> ()</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>
<!-- @@@takeFromDocument -->
<!-- $$$toInnerXml[overload1]$$$toInnerXml -->
<h3 class="fn"><a name="toInnerXml"></a><span class="type"><a href="qstring.html">QString</a></span> QWebElement::<span class="name">toInnerXml</span> () const</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>
<!-- @@@toInnerXml -->
<!-- $$$toOuterXml[overload1]$$$toOuterXml -->
<h3 class="fn"><a name="toOuterXml"></a><span class="type"><a href="qstring.html">QString</a></span> QWebElement::<span class="name">toOuterXml</span> () const</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>
<!-- @@@toOuterXml -->
<!-- $$$toPlainText[overload1]$$$toPlainText -->
<h3 class="fn"><a name="toPlainText"></a><span class="type"><a href="qstring.html">QString</a></span> QWebElement::<span class="name">toPlainText</span> () const</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>
<!-- @@@toPlainText -->
<!-- $$$toggleClass[overload1]$$$toggleClassconstQString& -->
<h3 class="fn"><a name="toggleClass"></a><span class="type">void</span> QWebElement::<span class="name">toggleClass</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <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>
<!-- @@@toggleClass -->
<!-- $$$webFrame[overload1]$$$webFrame -->
<h3 class="fn"><a name="webFrame"></a><span class="type"><a href="qwebframe.html">QWebFrame</a></span> * QWebElement::<span class="name">webFrame</span> () const</h3>
<p>Returns the web frame which this element is a part of. If the element is a null element, null is returned.</p>
<!-- @@@webFrame -->
<!-- $$$operator!=[overload1]$$$operator!=constQWebElement& -->
<h3 class="fn"><a name="operator-not-eq"></a><span class="type">bool</span> QWebElement::<span class="name">operator!=</span> ( const <span class="type">QWebElement</span> & <i>o</i> ) const</h3>
<p>Returns true if this element points to a different underlying DOM object than <i>o</i>; otherwise returns false.</p>
<!-- @@@operator!= -->
<!-- $$$operator=[overload1]$$$operator=constQWebElement& -->
<h3 class="fn"><a name="operator-eq"></a><span class="type">QWebElement</span> & QWebElement::<span class="name">operator=</span> ( const <span class="type">QWebElement</span> & <i>other</i> )</h3>
<p>Assigns <i>other</i> to this element and returns a reference to this element.</p>
<!-- @@@operator= -->
<!-- $$$operator==[overload1]$$$operator==constQWebElement& -->
<h3 class="fn"><a name="operator-eq-eq"></a><span class="type">bool</span> QWebElement::<span class="name">operator==</span> ( const <span class="type">QWebElement</span> & <i>o</i> ) const</h3>
<p>Returns true if this element points to the same underlying DOM object as <i>o</i>; otherwise returns false.</p>
<!-- @@@operator== -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Digia, Qt and their respective logos are trademarks of Digia Plc
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
