QDomAttr Class Reference
[XML module]

Detailed Description

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.

See also XML.

Member Function Documentation

QDomAttr::QDomAttr ()

QDomAttr::QDomAttr ( const QDomAttr & x )

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 cloneNode().

QDomAttr::~QDomAttr ()

bool QDomAttr::isAttr () const [virtual]

Reimplemented from QDomNode.

QString QDomAttr::name () const [virtual]

QDomNode::NodeType QDomAttr::nodeType () const [virtual]

Reimplemented from QDomNode.

QDomAttr & QDomAttr::operator= ( const QDomAttr & x )

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 cloneNode().

QDomElement QDomAttr::ownerElement () const [virtual]

void QDomAttr::setValue ( const QString & v ) [virtual]

See also value().

bool QDomAttr::specified () const [virtual]

See also setValue().

QString QDomAttr::value () const [virtual]

See also specified() and setValue().

This file is part of the Qt toolkit. Copyright © 1995-2005 Trolltech. All Rights Reserved.