|  | Home · Overviews · Examples |

# QDomAttr Class Reference
[com.trolltech.qt.xml module]

The `QDomAttr` class represents one attribute of a `QDomElement`. More...

Inherits `QDomNode`.

## Detailed Description

The `QDomAttr` class represents one attribute of a `QDomElement`.

For example, the following piece of XML produces an element with no children, but two attributes:

        <link href="http://www.trolltech.com" color="red" />

You can access the attributes of an element with code like this:

        QDomElement e = //...
        //...
        QDomAttr a = e.attributeNode("href");
        cout << a.value() << endl;                // prints "http://www.trolltech.com"
        a.setValue("http://doc.trolltech.com"); // change the node's attribute
        QDomAttr a2 = e.attributeNode("href");
        cout << a2.value() << endl;               // prints "http://doc.trolltech.com"

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 must use `cloneNode` to get an independent copy of the attribute.

`QDomAttr` can return the `name` and `value` of an attribute. An attribute's value is set with `setValue`. 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 `ownerElement`.

For further information about the Document Object Model see `http://www.w3.org/TR/REC-DOM-Level-1/` and `http://www.w3.org/TR/DOM-Level-2-Core/`. For a more general introduction of the DOM implementation see the `QDomDocument` documentation.