En esta página

QDomAttr Class

La clase QDomAttr representa un atributo de un objeto de tipo ` QDomElement`. Más información...

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

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

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)

Descripción detallada

Por ejemplo, el siguiente fragmento de XML genera un elemento sin hijos, pero con dos atributos:

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

Puedes acceder a los atributos de un elemento con código como este:

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"

Este ejemplo también muestra que al modificar un atributo obtenido de un elemento se modifica el atributo del propio elemento. Si no deseas modificar el valor del atributo del elemento, debes utilizar ` cloneNode()` para obtener una copia independiente del atributo.

QDomAttr puede devolver los valores de « name()» y « value()» de un atributo. El valor de un atributo se establece con « setValue()». Si « specified()» devuelve «true», el valor se ha establecido con « setValue()». El nodo al que está asociado este atributo (si lo hay) se devuelve mediante « ownerElement()».

Para obtener más información sobre el Modelo de Objetos de Documento (DOM), consulte http://www.w3.org/TR/REC-DOM-Level-1/ y http://www.w3.org/TR/DOM-Level-2-Core/. Para una introducción más general a la implementación del DOM, consulte la documentación de QDomDocument.

Documentación de las funciones de miembro

QDomAttr::QDomAttr()

Crea un atributo vacío.

QDomAttr::QDomAttr(const QDomAttr &attr)

Crea una copia de attr.

Los datos de la copia son compartidos (copia superficial): si se modifica un nodo, también se modificará el otro. Si deseas realizar una copia profunda, utiliza cloneNode().

QString QDomAttr::name() const

Devuelve el nombre del atributo.

QDomNode::NodeType QDomAttr::nodeType() const

Devuelve « AttributeNode ».

QDomElement QDomAttr::ownerElement() const

Devuelve el nodo del elemento al que está asociado este atributo o un objeto de tipo « null node » si este atributo no está asociado a ningún elemento.

void QDomAttr::setValue(const QString &value)

Establece el valor del atributo en « value ».

Véase también ` value()`.

bool QDomAttr::specified() const

Devuelve « true » si el usuario ha establecido el atributo mediante « setValue()». Devuelve « false » si no se ha especificado ni establecido el valor.

Véase también setValue().

QString QDomAttr::value() const

Devuelve el valor del atributo o una cadena vacía si no se ha especificado el atributo.

Véase también specified() y setValue().

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

Asigna ` other ` a este atributo del DOM.

Los datos de la copia se comparten (copia superficial): al modificar un nodo, también se modificará el otro. Si deseas realizar una copia profunda, utiliza 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.