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.


Copyright © 2008 Trolltech Trademarks
Qt Jambi 4.3.4_01