<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /tmp/qt-3.0-reggie-28534/qt-x11-free-3.0.2/src/xml/qdom.cpp:3585 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QDomAttr Class</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td 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="mainclasses.html">
<font color="#004faf">Main Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QDomAttr Class Reference<br><small>[<a href="xml.html">XML module</a>]</small></h1>
<p>The QDomAttr class represents one attribute of a QDomElement.
<a href="#details">More...</a>
<p><tt>#include <<a href="qdom-h.html">qdom.h</a>></tt>
<p>Inherits <a href="qdomnode.html">QDomNode</a>.
<p><a href="qdomattr-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li><div class=fn><a href="#QDomAttr"><b>QDomAttr</b></a> ()</div></li>
<li><div class=fn><a href="#QDomAttr-2"><b>QDomAttr</b></a> ( const QDomAttr & x )</div></li>
<li><div class=fn>QDomAttr & <a href="#operator-eq"><b>operator=</b></a> ( const QDomAttr & x )</div></li>
<li><div class=fn><a href="#~QDomAttr"><b>~QDomAttr</b></a> ()</div></li>
<li><div class=fn>virtual QString <a href="#name"><b>name</b></a> () const</div></li>
<li><div class=fn>virtual bool <a href="#specified"><b>specified</b></a> () const</div></li>
<li><div class=fn>virtual QDomElement <a href="#ownerElement"><b>ownerElement</b></a> () const</div></li>
<li><div class=fn>virtual QString <a href="#value"><b>value</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setValue"><b>setValue</b></a> ( const QString & v )</div></li>
<li><div class=fn>virtual QDomNode::NodeType <a href="#nodeType"><b>nodeType</b></a> () const</div></li>
<li><div class=fn>virtual bool <a href="#isAttr"><b>isAttr</b></a> () const</div></li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
The QDomAttr class represents one attribute of a <a href="qdomelement.html">QDomElement</a>.
<p>
<p> For example, the following piece of XML gives an element with no children,
but two attributes:
<p> <pre>
<link href="http://www.trolltech.com" color="red" />
</pre>
<p> One can use the attributes of an element with code like this:
<p> <pre>
<a href="qdomelement.html">QDomElement</a> e = //...
//...
QDomAttr a = e.<a href="qdomelement.html#attributeNode">attributeNode</a>( "href" );
cout << a.<a href="#value">value</a>() << endl // gives "http://www.trolltech.com"
a.<a href="#setValue">setValue</a>( "http://doc.trolltech.com" ); // change the node's attribute
QDomAttr a2 = e.<a href="qdomelement.html#attributeNode">attributeNode</a>( "href" );
cout << a2.<a href="#value">value</a>() << endl // gives "http://doc.trolltech.com"
</pre>
<p> This example also shows that changing an attribute received from an element
changes the attribute of the element. If you do not want to change the
value of the element's attribute you have to use <a href="qdomnode.html#cloneNode">cloneNode</a>() to get an
independent copy of the attribute.
<p> QDomAttr can return the <a href="#name">name</a>() and <a href="#value">value</a>() of an attribute. An
attribute's value is set with <a href="#setValue">setValue</a>(). If specified returns TRUE the
value was either set in the document or set with setValue(); otherwise the
value hasn't been set. The node this attribute is attached to (if any) is
returned by <a href="#ownerElement">ownerElement</a>().
<p> For further information about the Document Object Model see
<a href="http://www.w3.org/TR/REC-DOM-Level-1/">http://www.w3.org/TR/REC-DOM-Level-1/</a> and
<a href="http://www.w3.org/TR/DOM-Level-2-Core/">http://www.w3.org/TR/DOM-Level-2-Core/</a>.
For a more general introduction of the DOM implementation see the
<a href="qdomdocument.html">QDomDocument</a> documentation.
<p>See also <a href="xml-tools.html">XML</a>.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QDomAttr"></a>QDomAttr::QDomAttr ()
</h3>
Constructs an empty attribute.
<h3 class=fn><a name="QDomAttr-2"></a>QDomAttr::QDomAttr ( const <a href="qdomattr.html">QDomAttr</a> & x )
</h3>
Constructs a copy of <em>x</em>.
<p> The data of the copy is shared (shallow copy): modifying one node will also
change the other. If you want to make a <a href="shclass.html#deep-copy">deep copy</a>, use <a href="qdomnode.html#cloneNode">cloneNode</a>().
<h3 class=fn><a name="~QDomAttr"></a>QDomAttr::~QDomAttr ()
</h3>
Destroys the object and frees its resources.
<h3 class=fn>bool <a name="isAttr"></a>QDomAttr::isAttr () const<tt> [virtual]</tt>
</h3>
Returns TRUE.
<p>Reimplemented from <a href="qdomnode.html#isAttr">QDomNode</a>.
<h3 class=fn><a href="qstring.html">QString</a> <a name="name"></a>QDomAttr::name () const<tt> [virtual]</tt>
</h3>
Returns the name of the attribute.
<h3 class=fn><a href="qdomnode.html#NodeType-enum">QDomNode::NodeType</a> <a name="nodeType"></a>QDomAttr::nodeType () const<tt> [virtual]</tt>
</h3>
Returns <a href="qdomnode.html#NodeType-enum">AttributeNode</a>.
<p>Reimplemented from <a href="qdomnode.html#nodeType">QDomNode</a>.
<h3 class=fn><a href="qdomattr.html">QDomAttr</a> & <a name="operator-eq"></a>QDomAttr::operator= ( const <a href="qdomattr.html">QDomAttr</a> & x )
</h3>
Assigns <em>x</em> to this DOM attribute.
<p> The data of the copy is shared (shallow copy): modifying one node will also
change the other. If you want to make a <a href="shclass.html#deep-copy">deep copy</a>, use <a href="qdomnode.html#cloneNode">cloneNode</a>().
<h3 class=fn><a href="qdomelement.html">QDomElement</a> <a name="ownerElement"></a>QDomAttr::ownerElement () const<tt> [virtual]</tt>
</h3>
Returns the element node, this attribute is attached to. If this attribute is
not attached to any element, a null element node is returned (i.e. a node for
which <a href="qdomnode.html#isNull">QDomNode::isNull</a>() returns TRUE).
<h3 class=fn>void <a name="setValue"></a>QDomAttr::setValue ( const <a href="qstring.html">QString</a> & v )<tt> [virtual]</tt>
</h3>
Sets the value of the attribute to <em>v</em>.
<p> <p>See also <a href="#value">value</a>().
<h3 class=fn>bool <a name="specified"></a>QDomAttr::specified () const<tt> [virtual]</tt>
</h3>
Returns TRUE if the attribute has either been expicitly specified in the XML
document or was set by the user with <a href="#setValue">setValue</a>(). Returns FALSE if the value
hasn't been specified or set.
<p> <p>See also <a href="#setValue">setValue</a>().
<h3 class=fn><a href="qstring.html">QString</a> <a name="value"></a>QDomAttr::value () const<tt> [virtual]</tt>
</h3>
Returns the value of the attribute. Returns a null string
if the attribute has not been specified.
<p> <p>See also <a href="#specified">specified</a>() and <a href="#setValue">setValue</a>().
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright © 1995-2001
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright © 2001
<a href="http://www.trolltech.com">Trolltech</a><td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt version 3.0.2</div>
</table></div></address></body>
</html>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
112b0974ad288f6cd55bf971ee6026a9
>
files
>
1204
