QDomAttr Class

La classe QDomAttr représente un attribut d'une instance de ` QDomElement`. En savoir plus...

En-tête :	`#include <QDomAttr>`

CMake :	`find_package(Qt6 REQUIRED COMPONENTS Xml)` `target_link_libraries(mytarget PRIVATE Qt6::Xml)`
qmake :	`QT += xml`
Hérite de :	QDomNode

Liste de tous les membres, y compris les membres hérités
QDomAttr fait partie des classes XML.

Remarque : 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 fragment de code XML suivant génère un élément sans enfants, mais comportant deux attributs :

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

Vous pouvez accéder aux attributs d’un élément à l’aide d’un code tel que 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 lui-même. 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 méthodes name() et value() d’un attribut. La valeur d’un attribut est définie à l’aide de la méthode setValue(). Si la méthode specified() renvoie true, la valeur a été définie à l’aide de la méthode setValue(). Le nœud auquel cet attribut est associé (le cas échéant) est renvoyé par la méthode ownerElement().

Pour plus d’informations sur le Modèle objet de document (DOM), consultez 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, consultez la documentation de l’ QDomDocument.

Documentation sur les fonctions membres

QDomAttr::QDomAttr()

Crée un attribut vide.

QDomAttr::QDomAttr(const QDomAttr &attr)

Crée une copie de ` attr`.

Les données de la copie sont partagées (copie superficielle) : la modification d'un nœud entraîne également la modification de l'autre. Si vous souhaitez effectuer une copie profonde, utilisez cloneNode().

QString QDomAttr::name() const

Renvoie le nom de l'attribut.

QDomNode::NodeType QDomAttr::nodeType() const

Renvoie « AttributeNode ».

QDomElement QDomAttr::ownerElement() const

Renvoie le nœud de l'élément auquel cet attribut est associé, ou un objet de type « null node » si cet attribut n'est associé à aucun élément.

void QDomAttr::setValue(const QString &value)

Définit la valeur de l'attribut sur « value ».

Voir également value().

bool QDomAttr::specified() const

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

Voir également 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 également specified() et setValue().

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

Attribue la valeur « other » à cet attribut DOM.

© 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.