<?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>QDomElement 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">QDomElement Class Reference<br /><sup><sup>[<a href="qtxml.html">QtXml</a> module]</sup></sup></h1><p>The QDomElement class represents one element in the DOM tree.
<a href="#details">More...</a></p>
<p>Inherits <a href="qdomnode.html">QDomNode</a>.</p><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qdomelement.html#QDomElement">__init__</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#QDomElement-2">__init__</a></b> (<i>self</i>, QDomElement <i>x</i>)</li><li><div class="fn" />QString <b><a href="qdomelement.html#attribute">attribute</a></b> (<i>self</i>, QString <i>name</i>, QString <i>defaultValue</i> = QString())</li><li><div class="fn" />QDomAttr <b><a href="qdomelement.html#attributeNode">attributeNode</a></b> (<i>self</i>, QString <i>name</i>)</li><li><div class="fn" />QDomAttr <b><a href="qdomelement.html#attributeNodeNS">attributeNodeNS</a></b> (<i>self</i>, QString <i>nsURI</i>, QString <i>localName</i>)</li><li><div class="fn" />QString <b><a href="qdomelement.html#attributeNS">attributeNS</a></b> (<i>self</i>, QString <i>nsURI</i>, QString <i>localName</i>, QString <i>defaultValue</i> = QString())</li><li><div class="fn" />QDomNamedNodeMap <b><a href="qdomelement.html#attributes">attributes</a></b> (<i>self</i>)</li><li><div class="fn" />QDomNodeList <b><a href="qdomelement.html#elementsByTagName">elementsByTagName</a></b> (<i>self</i>, QString <i>tagname</i>)</li><li><div class="fn" />QDomNodeList <b><a href="qdomelement.html#elementsByTagNameNS">elementsByTagNameNS</a></b> (<i>self</i>, QString <i>nsURI</i>, QString <i>localName</i>)</li><li><div class="fn" />bool <b><a href="qdomelement.html#hasAttribute">hasAttribute</a></b> (<i>self</i>, QString <i>name</i>)</li><li><div class="fn" />bool <b><a href="qdomelement.html#hasAttributeNS">hasAttributeNS</a></b> (<i>self</i>, QString <i>nsURI</i>, QString <i>localName</i>)</li><li><div class="fn" />QDomNode.NodeType <b><a href="qdomelement.html#nodeType">nodeType</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#removeAttribute">removeAttribute</a></b> (<i>self</i>, QString <i>name</i>)</li><li><div class="fn" />QDomAttr <b><a href="qdomelement.html#removeAttributeNode">removeAttributeNode</a></b> (<i>self</i>, QDomAttr <i>oldAttr</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#removeAttributeNS">removeAttributeNS</a></b> (<i>self</i>, QString <i>nsURI</i>, QString <i>localName</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setAttribute">setAttribute</a></b> (<i>self</i>, QString <i>name</i>, QString <i>value</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setAttribute-2">setAttribute</a></b> (<i>self</i>, QString <i>name</i>, int <i>value</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setAttribute-3">setAttribute</a></b> (<i>self</i>, QString <i>name</i>, int <i>value</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setAttribute-4">setAttribute</a></b> (<i>self</i>, QString <i>name</i>, float <i>value</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setAttribute-5">setAttribute</a></b> (<i>self</i>, QString <i>name</i>, int <i>value</i>)</li><li><div class="fn" />QDomAttr <b><a href="qdomelement.html#setAttributeNode">setAttributeNode</a></b> (<i>self</i>, QDomAttr <i>newAttr</i>)</li><li><div class="fn" />QDomAttr <b><a href="qdomelement.html#setAttributeNodeNS">setAttributeNodeNS</a></b> (<i>self</i>, QDomAttr <i>newAttr</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setAttributeNS">setAttributeNS</a></b> (<i>self</i>, QString <i>nsURI</i>, QString <i>qName</i>, QString <i>value</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setAttributeNS-2">setAttributeNS</a></b> (<i>self</i>, QString <i>nsURI</i>, QString <i>qName</i>, int <i>value</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setAttributeNS-3">setAttributeNS</a></b> (<i>self</i>, QString <i>nsURI</i>, QString <i>qName</i>, int <i>value</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setAttributeNS-4">setAttributeNS</a></b> (<i>self</i>, QString <i>nsURI</i>, QString <i>qName</i>, float <i>value</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setAttributeNS-5">setAttributeNS</a></b> (<i>self</i>, QString <i>nsURI</i>, QString <i>qName</i>, int <i>value</i>)</li><li><div class="fn" /><b><a href="qdomelement.html#setTagName">setTagName</a></b> (<i>self</i>, QString <i>name</i>)</li><li><div class="fn" />QString <b><a href="qdomelement.html#tagName">tagName</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qdomelement.html#text">text</a></b> (<i>self</i>)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QDomElement class represents one element in the DOM
tree.</p>
<p>Elements have a <a href="qdomelement.html#tagName">tagName</a>()
and zero or more attributes associated with them. The tag name can
be changed with <a href="qdomelement.html#setTagName">setTagName</a>().</p>
<p>Element attributes are represented by <a href="qdomattr.html">QDomAttr</a> objects that can be queried using the
<a href="qdomelement.html#attributex">attribute</a>() and <a href="qdomelement.html#attributeNode">attributeNode</a>() functions. You
can set attributes with the <a href="qdomelement.html#setAttribute">setAttribute</a>() and <a href="qdomelement.html#setAttributeNode">setAttributeNode</a>()
functions. Attributes can be removed with <a href="qdomelement.html#removeAttribute">removeAttribute</a>(). There are
namespace-aware equivalents to these functions, i.e. <a href="qdomelement.html#setAttributeNS">setAttributeNS</a>(), <a href="qdomelement.html#setAttributeNodeNS">setAttributeNodeNS</a>() and
<a href="qdomelement.html#removeAttributeNS">removeAttributeNS</a>().</p>
<p>If you want to access the text of a node use <a href="qdomelement.html#text">text</a>(), e.g.</p>
<pre class="cpp">
<span class="type">QDomElement</span> e <span class="operator">=</span> <span class="comment">//...</span>
<span class="comment">//...</span>
<span class="type"><a href="qstring.html">QString</a></span> s <span class="operator">=</span> e<span class="operator">.</span><a href="qdomelement.html#text">text</a>()
</pre>
<p>The <a href="qdomelement.html#text">text</a>() function operates
recursively to find the text (since not all elements contain text).
If you want to find all the text in all of a node's children,
iterate over the children looking for <a href="qdomtext.html">QDomText</a> nodes, e.g.</p>
<pre class="cpp">
<span class="type"><a href="qstring.html">QString</a></span> text;
<span class="type">QDomElement</span> element <span class="operator">=</span> doc<span class="operator">.</span>documentElement();
<span class="keyword">for</span>(<span class="type"><a href="qdomnode.html">QDomNode</a></span> n <span class="operator">=</span> element<span class="operator">.</span>firstChild(); <span class="operator">!</span>n<span class="operator">.</span>isNull(); n <span class="operator">=</span> n<span class="operator">.</span>nextSibling())
{
<span class="type"><a href="qdomtext.html">QDomText</a></span> t <span class="operator">=</span> n<span class="operator">.</span>toText();
<span class="keyword">if</span> (<span class="operator">!</span>t<span class="operator">.</span>isNull())
text <span class="operator">+</span><span class="operator">=</span> t<span class="operator">.</span>data();
}
</pre>
<p>Note that we attempt to convert each node to a text node and use
<a href="qdomelement.html#text">text</a>() rather than using
<a href="qdomnode.html#firstChild">firstChild</a>().<a href="qdomnode.html#toText">toText</a>().data() or n.<a href="qdomnode.html#toText">toText</a>().data() directly on the node,
because the node may not be a text element.</p>
<p>You can get a list of all the decendents of an element which
have a specified tag name with <a href="qdomelement.html#elementsByTagName">elementsByTagName</a>() or
<a href="qdomelement.html#elementsByTagNameNS">elementsByTagNameNS</a>().</p>
<p>To browse the elements of a dom document use <a href="qdomnode.html#firstChildElement">firstChildElement</a>(), <a href="qdomnode.html#lastChildElement">lastChildElement</a>(), <a href="qdomnode.html#nextSiblingElement">nextSiblingElement</a>() and
<a href="qdomnode.html#previousSiblingElement">previousSiblingElement</a>().
For example, to iterate over all child elements called "entry" in a
root element called "database", you can use:</p>
<pre class="cpp">
<span class="type"><a href="qdomdocument.html">QDomDocument</a></span> doc <span class="operator">=</span> <span class="comment">// ...</span>
<span class="type">QDomElement</span> root <span class="operator">=</span> doc<span class="operator">.</span><a href="qdomnode.html#firstChildElement">firstChildElement</a>(<span class="string">"database"</span>);
<span class="type">QDomElement</span> elt <span class="operator">=</span> root<span class="operator">.</span><a href="qdomnode.html#firstChildElement">firstChildElement</a>(<span class="string">"entry"</span>);
<span class="keyword">for</span> (; <span class="operator">!</span>elt<span class="operator">.</span>isNull(); elt <span class="operator">=</span> elt<span class="operator">.</span>nextSiblingElement(<span class="string">"entry"</span>)) {
<span class="comment">// ...</span>
}
</pre>
<p>For further information about the Document Object Model see
<a href="http://www.w3.org/TR/REC-DOM-Level-1/">Level 1</a> and
<a href="http://www.w3.org/TR/DOM-Level-2-Core/">Level 2 Core</a>.
For a more general introduction of the DOM implementation see the
<a href="qdomdocument.html">QDomDocument</a> documentation.</p>
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QDomElement" />QDomElement.__init__ (<i>self</i>)</h3><p>Constructs an empty element. Use the <a href="qdomdocument.html#createElement">QDomDocument.createElement</a>()
function to construct elements with content.</p>
<h3 class="fn"><a name="QDomElement-2" />QDomElement.__init__ (<i>self</i>, <a href="qdomelement.html">QDomElement</a> <i>x</i>)</h3><p>Constructs a copy of <i>x</i>.</p>
<p>The data of the copy is shared (shallow copy): modifying one
node will also change the other. If you want to make a deep copy,
use <a href="qdomnode.html#cloneNode">cloneNode</a>().</p>
<h3 class="fn"><a name="attribute" />QString QDomElement.attribute (<i>self</i>, QString <i>name</i>, QString <i>defaultValue</i> = QString())</h3><h3 class="fn"><a name="attributeNode" /><a href="qdomattr.html">QDomAttr</a> QDomElement.attributeNode (<i>self</i>, QString <i>name</i>)</h3><p>Returns the <a href="qdomattr.html">QDomAttr</a> object that
corresponds to the attribute called <i>name</i>. If no such
attribute exists a <a href="qdomnode.html#isNull">null
attribute</a> is returned.</p>
<p><b>See also</b> <a href="qdomelement.html#setAttributeNode">setAttributeNode</a>(),
<a href="qdomelement.html#attributex">attribute</a>(), <a href="qdomelement.html#setAttribute">setAttribute</a>(), and <a href="qdomelement.html#attributeNodeNS">attributeNodeNS</a>().</p>
<h3 class="fn"><a name="attributeNodeNS" /><a href="qdomattr.html">QDomAttr</a> QDomElement.attributeNodeNS (<i>self</i>, QString <i>nsURI</i>, QString <i>localName</i>)</h3><p>Returns the <a href="qdomattr.html">QDomAttr</a> object that
corresponds to the attribute with the local name <i>localName</i>
and the namespace URI <i>nsURI</i>. If no such attribute exists a
<a href="qdomnode.html#isNull">null attribute</a> is returned.</p>
<p><b>See also</b> <a href="qdomelement.html#setAttributeNodeNS">setAttributeNodeNS</a>(),
<a href="qdomelement.html#setAttributeNode">setAttributeNode</a>(),
<a href="qdomelement.html#attributex">attribute</a>(), and <a href="qdomelement.html#setAttribute">setAttribute</a>().</p>
<h3 class="fn"><a name="attributeNS" />QString QDomElement.attributeNS (<i>self</i>, QString <i>nsURI</i>, QString <i>localName</i>, QString <i>defaultValue</i> = QString())</h3><p>Returns the attribute with the local name <i>localName</i> and
the namespace URI <i>nsURI</i>. If the attribute does not exist
<i>defValue</i> is returned.</p>
<p><b>See also</b> <a href="qdomelement.html#setAttributeNS">setAttributeNS</a>(), <a href="qdomelement.html#attributeNodeNS">attributeNodeNS</a>(), <a href="qdomelement.html#setAttributeNodeNS">setAttributeNodeNS</a>(), and
<a href="qdomelement.html#attributex">attribute</a>().</p>
<h3 class="fn"><a name="attributes" /><a href="qdomnamednodemap.html">QDomNamedNodeMap</a> QDomElement.attributes (<i>self</i>)</h3><p>Returns a <a href="qdomnamednodemap.html">QDomNamedNodeMap</a>
containing all this element's attributes.</p>
<p><b>See also</b> <a href="qdomelement.html#attributex">attribute</a>(), <a href="qdomelement.html#setAttribute">setAttribute</a>(), <a href="qdomelement.html#attributeNode">attributeNode</a>(), and <a href="qdomelement.html#setAttributeNode">setAttributeNode</a>().</p>
<h3 class="fn"><a name="elementsByTagName" /><a href="qdomnodelist.html">QDomNodeList</a> QDomElement.elementsByTagName (<i>self</i>, QString <i>tagname</i>)</h3><p>Returns a <a href="qdomnodelist.html">QDomNodeList</a>
containing all descendants of this element named <i>tagname</i>
encountered during a preorder traversal of the element subtree with
this element as its root. The order of the elements in the returned
list is the order they are encountered during the preorder
traversal.</p>
<p><b>See also</b> <a href="qdomelement.html#elementsByTagNameNS">elementsByTagNameNS</a>()
and <a href="qdomdocument.html#elementsByTagName">QDomDocument.elementsByTagName</a>().</p>
<h3 class="fn"><a name="elementsByTagNameNS" /><a href="qdomnodelist.html">QDomNodeList</a> QDomElement.elementsByTagNameNS (<i>self</i>, QString <i>nsURI</i>, QString <i>localName</i>)</h3><p>Returns a <a href="qdomnodelist.html">QDomNodeList</a>
containing all descendants of this element with local name
<i>localName</i> and namespace URI <i>nsURI</i> encountered during
a preorder traversal of the element subtree with this element as
its root. The order of the elements in the returned list is the
order they are encountered during the preorder traversal.</p>
<p><b>See also</b> <a href="qdomelement.html#elementsByTagName">elementsByTagName</a>() and
<a href="qdomdocument.html#elementsByTagNameNS">QDomDocument.elementsByTagNameNS</a>().</p>
<h3 class="fn"><a name="hasAttribute" />bool QDomElement.hasAttribute (<i>self</i>, QString <i>name</i>)</h3><p>Returns true if this element has an attribute called
<i>name</i>; otherwise returns false.</p>
<p><b>Note:</b> This function does not take the presence of
namespaces into account. As a result, the specified name will be
tested against fully-qualified attribute names that include any
namespace prefixes that may be present.</p>
<p>Use <a href="qdomelement.html#hasAttributeNS">hasAttributeNS</a>() to
explicitly test for attributes with specific namespaces and
names.</p>
<h3 class="fn"><a name="hasAttributeNS" />bool QDomElement.hasAttributeNS (<i>self</i>, QString <i>nsURI</i>, QString <i>localName</i>)</h3><p>Returns true if this element has an attribute with the local
name <i>localName</i> and the namespace URI <i>nsURI</i>; otherwise
returns false.</p>
<h3 class="fn"><a name="nodeType" /><a href="qdomnode.html#NodeType-enum">QDomNode.NodeType</a> QDomElement.nodeType (<i>self</i>)</h3><p>Returns <tt>ElementNode</tt>.</p>
<h3 class="fn"><a name="removeAttribute" />QDomElement.removeAttribute (<i>self</i>, QString <i>name</i>)</h3><p>Removes the attribute called name <i>name</i> from this
element.</p>
<p><b>See also</b> <a href="qdomelement.html#setAttribute">setAttribute</a>(), <a href="qdomelement.html#attributex">attribute</a>(), and <a href="qdomelement.html#removeAttributeNS">removeAttributeNS</a>().</p>
<h3 class="fn"><a name="removeAttributeNode" /><a href="qdomattr.html">QDomAttr</a> QDomElement.removeAttributeNode (<i>self</i>, <a href="qdomattr.html">QDomAttr</a> <i>oldAttr</i>)</h3><p>Removes the attribute <i>oldAttr</i> from the element and
returns it.</p>
<p><b>See also</b> <a href="qdomelement.html#attributeNode">attributeNode</a>() and <a href="qdomelement.html#setAttributeNode">setAttributeNode</a>().</p>
<h3 class="fn"><a name="removeAttributeNS" />QDomElement.removeAttributeNS (<i>self</i>, QString <i>nsURI</i>, QString <i>localName</i>)</h3><p>Removes the attribute with the local name <i>localName</i> and
the namespace URI <i>nsURI</i> from this element.</p>
<p><b>See also</b> <a href="qdomelement.html#setAttributeNS">setAttributeNS</a>(), <a href="qdomelement.html#attributeNS">attributeNS</a>(), and <a href="qdomelement.html#removeAttribute">removeAttribute</a>().</p>
<h3 class="fn"><a name="setAttribute" />QDomElement.setAttribute (<i>self</i>, QString <i>name</i>, QString <i>value</i>)</h3><p>Adds an attribute called <i>name</i> with value <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="qdomelement.html#attributex">attribute</a>(), <a href="qdomelement.html#setAttributeNode">setAttributeNode</a>(), and
<a href="qdomelement.html#setAttributeNS">setAttributeNS</a>().</p>
<h3 class="fn"><a name="setAttribute-2" />QDomElement.setAttribute (<i>self</i>, QString <i>name</i>, int <i>value</i>)</h3><p>This is an overloaded function.</p>
<p>The number is formatted according to the current locale.</p>
<h3 class="fn"><a name="setAttribute-3" />QDomElement.setAttribute (<i>self</i>, QString <i>name</i>, int <i>value</i>)</h3><p>This is an overloaded function.</p>
<p>The number is formatted according to the current locale.</p>
<h3 class="fn"><a name="setAttribute-4" />QDomElement.setAttribute (<i>self</i>, QString <i>name</i>, float <i>value</i>)</h3><p>This is an overloaded function.</p>
<p>The number is formatted according to the current locale.</p>
<h3 class="fn"><a name="setAttribute-5" />QDomElement.setAttribute (<i>self</i>, QString <i>name</i>, int <i>value</i>)</h3><p>This is an overloaded function.</p>
<p>The number is formatted according to the current locale.</p>
<h3 class="fn"><a name="setAttributeNode" /><a href="qdomattr.html">QDomAttr</a> QDomElement.setAttributeNode (<i>self</i>, <a href="qdomattr.html">QDomAttr</a> <i>newAttr</i>)</h3><p>Adds the attribute <i>newAttr</i> to this element.</p>
<p>If the element has another attribute that has the same name as
<i>newAttr</i>, this function replaces that attribute and returns
it; otherwise the function returns a <a href="qdomnode.html#isNull">null attribute</a>.</p>
<p><b>See also</b> <a href="qdomelement.html#attributeNode">attributeNode</a>(), <a href="qdomelement.html#setAttribute">setAttribute</a>(), and <a href="qdomelement.html#setAttributeNodeNS">setAttributeNodeNS</a>().</p>
<h3 class="fn"><a name="setAttributeNodeNS" /><a href="qdomattr.html">QDomAttr</a> QDomElement.setAttributeNodeNS (<i>self</i>, <a href="qdomattr.html">QDomAttr</a> <i>newAttr</i>)</h3><p>Adds the attribute <i>newAttr</i> to this element.</p>
<p>If the element has another attribute that has the same local
name and namespace URI as <i>newAttr</i>, this function replaces
that attribute and returns it; otherwise the function returns a
<a href="qdomnode.html#isNull">null attribute</a>.</p>
<p><b>See also</b> <a href="qdomelement.html#attributeNodeNS">attributeNodeNS</a>(), <a href="qdomelement.html#setAttributeNS">setAttributeNS</a>(), and
<a href="qdomelement.html#setAttributeNode">setAttributeNode</a>().</p>
<h3 class="fn"><a name="setAttributeNS" />QDomElement.setAttributeNS (<i>self</i>, QString <i>nsURI</i>, QString <i>qName</i>, QString <i>value</i>)</h3><p>Adds an attribute with the qualified name <i>qName</i> and the
namespace URI <i>nsURI</i> with the value <i>value</i>. If an
attribute with the same local name and namespace URI exists, its
prefix is replaced by the prefix of <i>qName</i> and its value is
repaced by <i>value</i>.</p>
<p>Although <i>qName</i> is the qualified name, the local name is
used to decide if an existing attribute's value should be
replaced.</p>
<p><b>See also</b> <a href="qdomelement.html#attributeNS">attributeNS</a>(), <a href="qdomelement.html#setAttributeNodeNS">setAttributeNodeNS</a>(), and
<a href="qdomelement.html#setAttribute">setAttribute</a>().</p>
<h3 class="fn"><a name="setAttributeNS-2" />QDomElement.setAttributeNS (<i>self</i>, QString <i>nsURI</i>, QString <i>qName</i>, int <i>value</i>)</h3><p>This is an overloaded function.</p>
<h3 class="fn"><a name="setAttributeNS-3" />QDomElement.setAttributeNS (<i>self</i>, QString <i>nsURI</i>, QString <i>qName</i>, int <i>value</i>)</h3><p>This is an overloaded function.</p>
<h3 class="fn"><a name="setAttributeNS-4" />QDomElement.setAttributeNS (<i>self</i>, QString <i>nsURI</i>, QString <i>qName</i>, float <i>value</i>)</h3><p>This is an overloaded function.</p>
<h3 class="fn"><a name="setAttributeNS-5" />QDomElement.setAttributeNS (<i>self</i>, QString <i>nsURI</i>, QString <i>qName</i>, int <i>value</i>)</h3><p>This is an overloaded function.</p>
<h3 class="fn"><a name="setTagName" />QDomElement.setTagName (<i>self</i>, QString <i>name</i>)</h3><p>Sets this element's tag name to <i>name</i>.</p>
<p><b>See also</b> <a href="qdomelement.html#tagName">tagName</a>().</p>
<h3 class="fn"><a name="tagName" />QString QDomElement.tagName (<i>self</i>)</h3><p>Returns the tag name of this element. For an XML element like
this:</p>
<pre class="cpp">
<span class="operator"><</span>img src<span class="operator">=</span><span class="string">"myimg.png"</span><span class="operator">></span>
</pre>
<p>the tagname would return "img".</p>
<p><b>See also</b> <a href="qdomelement.html#setTagName">setTagName</a>().</p>
<h3 class="fn"><a name="text" />QString QDomElement.text (<i>self</i>)</h3><p>Returns the element's text or an empty string.</p>
<p>Example:</p>
<pre class="cpp">
<span class="operator"><</span>h1<span class="operator">></span>Hello <span class="operator"><</span>b<span class="operator">></span><span class="type"><a href="qt.html">Qt</a></span><span class="operator"><</span><span class="operator">/</span>b<span class="operator">></span> <span class="operator"><</span><span class="operator">!</span><span class="operator">[</span>CDATA<span class="operator">[</span><span class="operator"><</span>xml is cool<span class="operator">></span><span class="operator">]</span><span class="operator">]</span><span class="operator">></span><span class="operator"><</span><span class="operator">/</span>h1<span class="operator">></span>
</pre>
<p>The function text() of the <a href="qdomelement.html">QDomElement</a> for the <tt><h1></tt> tag,
will return the following text:</p>
<pre class="cpp">
Hello <span class="type"><a href="qt.html">Qt</a></span> <span class="operator"><</span>xml is cool<span class="operator">></span>
</pre>
<p>Comments are ignored by this function. It only evaluates
<a href="qdomtext.html">QDomText</a> and <a href="qdomcdatasection.html">QDomCDATASection</a> objects.</p>
<address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt 4.10.3 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2012</td><td align="right" width="25%">Qt 4.8.5</td></tr></table></div></address></body></html>
