En esta página

QDomElement Class

La clase QDomElement representa un elemento del árbol DOM. Más información...

Encabezado: #include <QDomElement>
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

QDomElement()
QDomElement(const QDomElement &element)
QString attribute(const QString &name, const QString &defValue = QString()) const
QString attributeNS(const QString &nsURI, const QString &localName, const QString &defValue = QString()) const
QDomAttr attributeNode(const QString &name)
QDomAttr attributeNodeNS(const QString &nsURI, const QString &localName)
QDomNamedNodeMap attributes() const
QDomNodeList elementsByTagName(const QString &tagname) const
QDomNodeList elementsByTagNameNS(const QString &nsURI, const QString &localName) const
bool hasAttribute(const QString &name) const
bool hasAttributeNS(const QString &nsURI, const QString &localName) const
QDomNode::NodeType nodeType() const
void removeAttribute(const QString &name)
void removeAttributeNS(const QString &nsURI, const QString &localName)
QDomAttr removeAttributeNode(const QDomAttr &oldAttr)
void setAttribute(const QString &name, const QString &value)
void setAttribute(const QString &name, double value)
void setAttribute(const QString &name, float value)
void setAttribute(const QString &name, int value)
void setAttribute(const QString &name, qlonglong value)
void setAttribute(const QString &name, qulonglong value)
void setAttribute(const QString &name, uint value)
void setAttributeNS(const QString &nsURI, const QString &qName, const QString &value)
void setAttributeNS(const QString &nsURI, const QString &qName, double value)
void setAttributeNS(const QString &nsURI, const QString &qName, int value)
void setAttributeNS(const QString &nsURI, const QString &qName, qlonglong value)
void setAttributeNS(const QString &nsURI, const QString &qName, qulonglong value)
void setAttributeNS(const QString &nsURI, const QString &qName, uint value)
QDomAttr setAttributeNode(const QDomAttr &newAttr)
QDomAttr setAttributeNodeNS(const QDomAttr &newAttr)
void setTagName(const QString &name)
QString tagName() const
QString text() const
QDomElement &operator=(const QDomElement &other)

Descripción detallada

Los elementos tienen un nombre de etiqueta ( tagName()) y cero o más atributos asociados a ellos. El nombre de la etiqueta se puede cambiar con la función setTagName().

Los atributos de los elementos están representados por objetos ` QDomAttr `, a los que se puede acceder mediante las funciones ` attribute()` y ` attributeNode()`. Se pueden establecer atributos con las funciones ` setAttribute()` y ` setAttributeNode()`. Los atributos se pueden eliminar con ` removeAttribute()`. Existen equivalentes de estas funciones que tienen en cuenta el espacio de nombres, es decir, ` setAttributeNS()`, ` setAttributeNodeNS()` y ` removeAttributeNS()`.

Si deseas acceder al texto de un nodo, utiliza ` text()`, por ejemplo:

QDomElement e = //...
//...
QString s = e.text()

La función text() opera de forma recursiva para encontrar el texto (ya que no todos los elementos contienen texto). Si desea encontrar todo el texto de todos los hijos de un nodo, recorra los hijos buscando nodos QDomText, p. ej.

QString text;
QDomElement element = doc.documentElement();
for(QDomNode n = element.firstChild(); !n.isNull(); n = n.nextSibling())
{
    QDomText t = n.toText();
    if (!t.isNull())
        text += t.data();
}

Ten en cuenta que intentamos convertir cada nodo en un nodo de texto y utilizamos ` text()` en lugar de ` firstChild()`. No utilices `toText().data()` o `n.toText().data()` directamente sobre el nodo, ya que es posible que el nodo no sea un elemento de texto.

Puedes obtener una lista de todos los descendientes de un elemento que tengan un nombre de etiqueta específico con ` elementsByTagName()` o ` elementsByTagNameNS()`.

Para recorrer los elementos de un documento DOM, utiliza firstChildElement(), lastChildElement(), nextSiblingElement() y previousSiblingElement(). Por ejemplo, para recorrer todos los elementos hijos denominados «entry» en un elemento raíz denominado «database», puedes utilizar:

QDomDocument doc = // ...
QDomElement root = doc.firstChildElement("database");
QDomElement elt = root.firstChildElement("entry");
for (; !elt.isNull(); elt = elt.nextSiblingElement("entry")) {
    // ...
}

Para obtener más información sobre el Modelo de Objetos de Documento (DOM), consulta los niveles 1 y 2 Core. Para una introducción más general a la implementación del DOM, consulta la documentación de QDomDocument.

Documentación de las funciones de miembro

QDomElement::QDomElement()

Crea un elemento vacío. Utiliza la función ` QDomDocument::createElement()` para crear elementos con contenido.

QDomElement::QDomElement(const QDomElement &element)

Crea una copia de element.

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

QString QDomElement::attribute(const QString &name, const QString &defValue = QString()) const

Devuelve el atributo denominado « name ». Si el atributo no existe, se devuelve « defValue ».

Véase también setAttribute(), attributeNode(), setAttributeNode() y attributeNS().

QString QDomElement::attributeNS(const QString &nsURI, const QString &localName, const QString &defValue = QString()) const

Devuelve el atributo con el nombre local localName y el URI del espacio de nombres nsURI. Si el atributo no existe, se devuelve defValue.

Véase también setAttributeNS(), attributeNodeNS(), setAttributeNodeNS() y attribute().

QDomAttr QDomElement::attributeNode(const QString &name)

Devuelve el objeto « QDomAttr » correspondiente al atributo denominado « name ». Si dicho atributo no existe, se devuelve un objeto « null attribute ».

Véase también setAttributeNode(), attribute(), setAttribute() y attributeNodeNS().

QDomAttr QDomElement::attributeNodeNS(const QString &nsURI, const QString &localName)

Devuelve el objeto ` QDomAttr ` que corresponde al atributo con el nombre local ` localName ` y el URI del espacio de nombres ` nsURI`. Si no existe dicho atributo, se devuelve un ` null attribute `.

Véase también setAttributeNodeNS(), setAttributeNode(), attribute() y setAttribute().

QDomNamedNodeMap QDomElement::attributes() const

Devuelve un objeto ` QDomNamedNodeMap ` que contiene todos los atributos de este elemento.

Véase también attribute(), setAttribute(), attributeNode() y setAttributeNode().

QDomNodeList QDomElement::elementsByTagName(const QString &tagname) const

Devuelve un objeto ` QDomNodeList ` que contiene todos los descendientes de este elemento denominados « tagname » que se encuentran durante un recorrido en preorden del subárbol del elemento, teniendo este elemento como raíz. El orden de los elementos en la lista devuelta es el orden en que se encuentran durante el recorrido en preorden.

Véase también ` elementsByTagNameNS()` y ` QDomDocument::elementsByTagName()`.

QDomNodeList QDomElement::elementsByTagNameNS(const QString &nsURI, const QString &localName) const

Devuelve una lista de elementos ( QDomNodeList ) que contiene todos los descendientes de este elemento con el nombre local localName y el URI de espacio de nombres nsURI encontrados durante un recorrido en preorden del subárbol del elemento, teniendo este elemento como raíz. El orden de los elementos en la lista devuelta es el orden en el que se encuentran durante el recorrido en preorden.

Véase también elementsByTagName() y QDomDocument::elementsByTagNameNS().

bool QDomElement::hasAttribute(const QString &name) const

Devuelve « true » si este elemento tiene un atributo llamado « name »; en caso contrario, devuelve « false ».

Nota: Esta función no tiene en cuenta la presencia de espacios de nombres. Por lo tanto, el nombre especificado se comparará con los nombres de atributos completos, que incluyen cualquier prefijo de espacio de nombres que pueda estar presente.

Utiliza ` hasAttributeNS()` para comprobar explícitamente si existen atributos con espacios de nombres y nombres específicos.

bool QDomElement::hasAttributeNS(const QString &nsURI, const QString &localName) const

Devuelve « true » si este elemento tiene un atributo con el nombre local « localName » y el URI del espacio de nombres « nsURI »; en caso contrario, devuelve «false».

QDomNode::NodeType QDomElement::nodeType() const

Devuelve « ElementNode ».

void QDomElement::removeAttribute(const QString &name)

Elimina el atributo denominado «name» name de este elemento.

Véase también setAttribute(), attribute() y removeAttributeNS().

void QDomElement::removeAttributeNS(const QString &nsURI, const QString &localName)

Elimina el atributo con el nombre local « localName » y el URI del espacio de nombres « nsURI » de este elemento.

Véase también setAttributeNS(), attributeNS() y removeAttribute().

QDomAttr QDomElement::removeAttributeNode(const QDomAttr &oldAttr)

Elimina el atributo « oldAttr » del elemento y lo devuelve.

Véase también « attributeNode()» y « setAttributeNode()».

void QDomElement::setAttribute(const QString &name, const QString &value)

Añade un atributo llamado « name » con el valor « value ». Si ya existe un atributo con el mismo nombre, su valor se sustituye por « value ».

Véanse también attribute(), setAttributeNode() y setAttributeNS().

void QDomElement::setAttribute(const QString &name, double value)

El formato siempre utiliza QLocale::C.

Se trata de una función sobrecargada.

void QDomElement::setAttribute(const QString &name, float value)

El formato siempre utiliza « QLocale::C ».

Se trata de una función sobrecargada.

void QDomElement::setAttribute(const QString &name, int value)

El formato siempre utiliza « QLocale::C ».

Se trata de una función sobrecargada.

void QDomElement::setAttribute(const QString &name, qlonglong value)

El formato siempre utiliza « QLocale::C ».

Se trata de una función sobrecargada.

void QDomElement::setAttribute(const QString &name, qulonglong value)

El formato siempre utiliza « QLocale::C ».

Se trata de una función sobrecargada.

void QDomElement::setAttribute(const QString &name, uint value)

El formato siempre utiliza « QLocale::C ».

Se trata de una función sobrecargada.

void QDomElement::setAttributeNS(const QString &nsURI, const QString &qName, const QString &value)

Añade un atributo con el nombre calificado qName y el URI del espacio de nombres nsURI, con el valor value. Si ya existe un atributo con el mismo nombre local y el mismo URI del espacio de nombres, su prefijo se sustituye por el prefijo de qName y su valor se sustituye por value.

Aunque qName es el nombre cualificado, se utiliza el nombre local para decidir si se debe sustituir el valor de un atributo existente.

Véase también attributeNS(), setAttributeNodeNS() y setAttribute().

void QDomElement::setAttributeNS(const QString &nsURI, const QString &qName, double value)

Esta es una función sobrecargada.

void QDomElement::setAttributeNS(const QString &nsURI, const QString &qName, int value)

Esta es una función sobrecargada.

void QDomElement::setAttributeNS(const QString &nsURI, const QString &qName, qlonglong value)

Esta es una función sobrecargada.

void QDomElement::setAttributeNS(const QString &nsURI, const QString &qName, qulonglong value)

Esta es una función sobrecargada.

void QDomElement::setAttributeNS(const QString &nsURI, const QString &qName, uint value)

Esta es una función sobrecargada.

QDomAttr QDomElement::setAttributeNode(const QDomAttr &newAttr)

Añade el atributo « newAttr » a este elemento.

Si el elemento tiene otro atributo con el mismo nombre que « newAttr », esta función sustituye dicho atributo y lo devuelve; en caso contrario, la función devuelve un objeto « null attribute ».

Véase también attributeNode(), setAttribute() y setAttributeNodeNS().

QDomAttr QDomElement::setAttributeNodeNS(const QDomAttr &newAttr)

Añade el atributo newAttr a este elemento.

Si el elemento tiene otro atributo con el mismo nombre local y URI de espacio de nombres que « newAttr », esta función sustituye dicho atributo y lo devuelve; en caso contrario, la función devuelve un « null attribute ».

Véase también attributeNodeNS(), setAttributeNS() y setAttributeNode().

void QDomElement::setTagName(const QString &name)

Establece el nombre de la etiqueta de este elemento como « name ».

Véase también tagName().

QString QDomElement::tagName() const

Devuelve el nombre de la etiqueta de este elemento. Para un elemento XML como este:

<img src="myimg.png">

la función tagname devolvería «img».

Véase también setTagName().

QString QDomElement::text() const

Devuelve el texto del elemento o una cadena vacía.

Ejemplo:

<h1>Hello <b>Qt</b> <![CDATA[<xml is cool>]]></h1>

La función text() del objeto QDomElement correspondiente a la etiqueta <h1> devolverá el siguiente texto:

Hello Qt <xml is cool>

Esta función ignora los comentarios. Solo evalúa objetos de tipo ` QDomText ` y ` QDomCDATASection `.

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

Asigna ` other ` a este elemento 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.