Sur cette page

QDomAttr Class

La classe QDomAttr représente un attribut d'un site QDomElement. Plus....

En-tête : #include <QDomAttr>
CMake : find_package(Qt6 REQUIRED COMPONENTS Xml)
target_link_libraries(mytarget PRIVATE Qt6::Xml)
qmake : QT += xml
Héritages : QDomNode

Note : Toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

QDomAttr()
QDomAttr(const QDomAttr &attr)
QString name() const
QDomNode::NodeType nodeType() const
QDomElement ownerElement() const
void setValue(const QString &value)
bool specified() const
QString value() const
QDomAttr &operator=(const QDomAttr &other)

Description détaillée

Par exemple, le morceau de XML suivant produit un élément sans enfant, mais avec deux attributs :

<link href="http://qt-project.org" color="red" />

Vous pouvez accéder aux attributs d'un élément avec un code comme celui-ci :

QDomElement e;
//...
QDomAttr a = e.attributeNode("href");
cout << qPrintable(a.value()) << '\n';   // prints "http://qt-project.org"
a.setValue("http://qt-project.org/doc"); // change the node's attribute
QDomAttr a2 = e.attributeNode("href");
cout << qPrintable(a2.value()) << '\n';  // prints "http://qt-project.org/doc"

Cet exemple montre également que la modification d'un attribut reçu d'un élément modifie l'attribut de l'élément. Si vous ne souhaitez pas modifier la valeur de l'attribut de l'élément, vous devez utiliser cloneNode() pour obtenir une copie indépendante de l'attribut.

QDomAttr peut renvoyer les valeurs name() et value() d'un attribut. La valeur d'un attribut est définie à l'aide de setValue(). Si specified() renvoie vrai, la valeur a été définie avec setValue(). Le nœud auquel cet attribut est attaché (le cas échéant) est renvoyé par ownerElement().

Pour plus d'informations sur le modèle d'objet de document, voir http://www.w3.org/TR/REC-DOM-Level-1/ et http://www.w3.org/TR/DOM-Level-2-Core/. Pour une introduction plus générale à l'implémentation du DOM, voir la documentation QDomDocument.

Documentation des fonctions membres

QDomAttr::QDomAttr()

Construit un attribut vide.

QDomAttr::QDomAttr(const QDomAttr &attr)

Construit une copie de attr.

Les données de la copie sont partagées (copie superficielle) : modifier un noeud modifiera également l'autre. Si vous voulez faire une copie profonde, utilisez cloneNode().

QString QDomAttr::name() const

Renvoie le nom de l'attribut.

QDomNode::NodeType QDomAttr::nodeType() const

Retourne AttributeNode.

QDomElement QDomAttr::ownerElement() const

Renvoie le nœud de l'élément auquel cet attribut est attaché ou une adresse null node si cet attribut n'est attaché à aucun élément.

void QDomAttr::setValue(const QString &value)

Fixe la valeur de l'attribut à value.

Voir aussi value().

bool QDomAttr::specified() const

Renvoie true si l'attribut a été défini par l'utilisateur à l'aide de setValue(). Renvoie false si la valeur n'a pas été spécifiée ou définie.

Voir aussi setValue().

QString QDomAttr::value() const

Renvoie la valeur de l'attribut ou une chaîne vide si l'attribut n'a pas été spécifié.

Voir aussi specified() et setValue().

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

Assigne other à cet attribut DOM.

Les données de la copie sont partagées (copie superficielle) : modifier un nœud modifiera également l'autre. Si vous voulez faire une copie profonde, utilisez cloneNode().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.