<!-- clanlib header begin -->
<HTML>
<HEAD>
<TITLE>CL_DomAttr - ClanLib Game SDK</TITLE>
<STYLE TYPE="text/css"><!--
HTML BODY
{
font-family: verdana, helvetica, sans-serif;
font-size: 12px;
}
H1 { font-size: 22px; }
H2 { font-size: 18px; }
H3 { font-size: 16px; }
H4 { font-size: 14px; }
P { font-size: 12px; }
LI { font-size: 12px; }
--></STYLE>
</HEAD>
<body bgcolor=white text=black link=blue vlink=#800080>
<center>
<img src="http://clanlib.org/gfx/clanlib.png">
</center>
<!-- clanlib header end -->
<center>
<p>
<a href="http://clanlib.org/docs.html">Home</a> |
<a href="classes.html">All Classes</a> |
<a href="modules.html">Grouped Classes</a> |
<a href="index.html">Index</a> |
<a href="search.html">Search</a>
</p>
</center>
<h1>Class CL_DomAttr</h1>
<p> DOM Attribute class. <a href="#description">More...</a></p>
<p>Derived from:
<a href="CL_DomNode.html">CL_DomNode</a>
<br>
Derived by:
<i>none</i>
<br>Group: Core (XML)</p>
<p>
#include <ClanLib/core.h>
<p>
<table border=0 width=100%>
</table>
<p><b>Construction:</b></p>
<table border=0 width=100%>
<tr><td width=30% valign=top><p><a href="CL_DomAttr__CL_DomAttr.html">CL_DomAttr</a></p></td><td valign=top><p> Constructs a DOM Attr handle.</p></td></tr></table>
<p><b>Attributes:</b></p>
<table border=0 width=100%>
<tr><td width=30% valign=top><p><a href="CL_DomAttr__get_name.html">get_name</a></p></td><td valign=top><p> Returns the name of this attribute.</p></td></tr><tr><td width=30% valign=top><p><a href="CL_DomAttr__get_specified.html">get_specified</a></p></td><td valign=top><p> If this attribute was explicitly given a value in the original document, this is true; otherwise, it is false.</p></td></tr><tr><td width=30% valign=top><p><a href="CL_DomAttr__get_value.html">get_value</a></p></td><td valign=top><p> Returns the value of the attribute.</p></td></tr><tr><td width=30% valign=top><p><a href="CL_DomAttr__set_value.html">set_value</a></p></td><td valign=top><p> Sets the value of the attribute.</p></td></tr></table>
<a name="#description"><p><b>Detailed description:</b></p>
!group=Core/XML!
!header=core.h!
<p>The Attr interface represents an attribute in an Element object. Typically
the allowable values for the attribute are defined in a document type definition.</p>
<p>Attr objects inherit the Node interface, but since they are not actually child
nodes of the element they describe, the DOM does not consider them part of the
document tree. Thus, the Node attributes parentNode, previousSibling, and nextSibling
have a null value for Attr objects. The DOM takes the view that attributes are
properties of elements rather than having a separate identity from the elements
they are associated with; this should make it more efficient to implement such
features as default attributes associated with all elements of a given type. Furthermore,
Attr nodes may not be immediate children of a DocumentFragment. However, they can
be associated with Element nodes contained within a DocumentFragment. In short,
users and implementors of the DOM need to be aware that Attr nodes have some
things in common with other objects inheriting the Node interface, but they also
are quite distinct.</p>
<p>The attribute's effective value is determined as follows: if this attribute
has been explicitly assigned any value, that value is the attribute's effective
value; otherwise, if there is a declaration for this attribute, and that declaration
includes a default value, then that default value is the attribute's effective value;
otherwise, the attribute does not exist on this element in the structure model until
it has been explicitly added. Note that the nodeValue attribute on the Attr instance
can also be used to retrieve the string version of the attribute's value(s).</p>
<p>In XML, where the value of an attribute can contain entity references, the child
nodes of the Attr node provide a representation in which entity references are not
expanded. These child nodes may be either Text or EntityReference nodes. Because the
attribute type may be unknown, there are no tokenized attribute values.</p>
<!-- clanlib footer begin -->
<center><br><br><font color="#a0a0a0">
Questions or comments, write to the <a href="http://clanlib.org/contact.html">ClanLib mailing list</a>.
</font></center>
</body>
</html>
<!-- clanlib footer end -->
