QDomAttr Class

Die Klasse QDomAttr repräsentiert ein Attribut einer QDomElement. Mehr....

Kopfzeile: #include <QDomAttr>
CMake: find_package(Qt6 REQUIRED COMPONENTS Xml)
target_link_libraries(mytarget PRIVATE Qt6::Xml)
qmake: QT += xml
Vererbungen: QDomNode

Hinweis: Alle Funktionen in dieser Klasse sind reentrant.

Öffentliche Funktionen

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)

Detaillierte Beschreibung

Das folgende XML-Stück erzeugt zum Beispiel ein Element ohne Kinder, aber mit zwei Attributen:

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

Sie können auf die Attribute eines Elements mit Code wie diesem zugreifen:

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"

Dieses Beispiel zeigt auch, dass die Änderung eines von einem Element erhaltenen Attributs das Attribut des Elements ändert. Wenn Sie den Wert des Attributs des Elements nicht ändern wollen, müssen Sie cloneNode() verwenden, um eine unabhängige Kopie des Attributs zu erhalten.

QDomAttr kann die name() und value() eines Attributs zurückgeben. Der Wert eines Attributs wird mit setValue() gesetzt. Wenn specified() true zurückgibt, wurde der Wert mit setValue() gesetzt. Der Knoten, an den dieses Attribut angehängt ist (falls vorhanden), wird von ownerElement() zurückgegeben.

Weitere Informationen über das Document Object Model finden Sie unter http://www.w3.org/TR/REC-DOM-Level-1/ und http://www.w3.org/TR/DOM-Level-2-Core/. Eine allgemeinere Einführung in die DOM-Implementierung finden Sie in der Dokumentation QDomDocument.

Dokumentation der Mitgliedsfunktionen

QDomAttr::QDomAttr()

Konstruiert ein leeres Attribut.

QDomAttr::QDomAttr(const QDomAttr &attr)

Konstruiert eine Kopie von attr.

Die Daten der Kopie werden gemeinsam genutzt (oberflächliche Kopie): Die Änderung eines Knotens wird auch den anderen verändern. Wenn Sie eine tiefe Kopie erstellen möchten, verwenden Sie cloneNode().

QString QDomAttr::name() const

Gibt den Namen des Attributs zurück.

QDomNode::NodeType QDomAttr::nodeType() const

Rückgabe AttributeNode.

QDomElement QDomAttr::ownerElement() const

Gibt den Elementknoten zurück, an den dieses Attribut angehängt ist, oder ein null node, wenn dieses Attribut an kein Element angehängt ist.

void QDomAttr::setValue(const QString &value)

Setzt den Wert des Attributs auf value.

Siehe auch value().

bool QDomAttr::specified() const

Gibt true zurück, wenn das Attribut vom Benutzer mit setValue() gesetzt wurde. Gibt false zurück, wenn der Wert nicht angegeben oder gesetzt wurde.

Siehe auch setValue().

QString QDomAttr::value() const

Gibt den Wert des Attributs zurück oder einen leeren String, wenn das Attribut nicht angegeben wurde.

Siehe auch specified() und setValue().

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

Weist diesem DOM-Attribut other zu.

Die Daten der Kopie werden gemeinsam genutzt (flache Kopie): Die Änderung eines Knotens wird auch den anderen verändern. Wenn Sie eine tiefe Kopie erstellen möchten, verwenden Sie cloneNode().

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