QDomElement Class

La clase QDomElement representa un elemento en el árbol DOM. Más...

Cabecera:	`#include <QDomElement>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Xml)` `target_link_libraries(mytarget PRIVATE Qt6::Xml)`
qmake:	`QT += xml`
Hereda:	QDomNode

Lista de todos los miembros, incluyendo los heredados
QDomElement es parte de Clases XML.

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 tagName() y cero o más atributos asociados a ellos. El nombre de la etiqueta puede modificarse con setTagName().

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

Si desea acceder al texto de un nodo, utilice 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 en todos los hijos de un nodo, itere sobre los hijos buscando los 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();
}

Tenga en cuenta que intentamos convertir cada nodo en un nodo de texto y usamos text() en lugar de usar firstChild().toText().data() o n.toText().data() directamente en el nodo, porque puede que el nodo no sea un elemento de texto.

Puede obtener una lista de todos los descendientes de un elemento que tengan un nombre de etiqueta especificado con elementsByTagName() o elementsByTagNameNS().

Para recorrer los elementos de un documento dom utilice firstChildElement(), lastChildElement(), nextSiblingElement() y previousSiblingElement(). Por ejemplo, para iterar sobre todos los elementos hijos llamados "entrada" en un elemento raíz llamado "base de datos", puede utilizar:

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

Para más información sobre el Modelo de Objetos de Documento, véase Núcleo de Nivel 1 y Nivel 2. Para una introducción más general a la implementación del DOM, consulte la documentación de QDomDocument.

Documentación de las funciones miembro

QDomElement::QDomElement()

Construye un elemento vacío. Utilice la función QDomDocument::createElement() para construir elementos con contenido.

QDomElement::QDomElement(const QDomElement &element)

Construye una copia de element.

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

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

Devuelve el atributo llamado 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 que corresponde al atributo llamado name. Si no existe tal atributo se devuelve 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 null attribute.

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

QDomNamedNodeMap QDomElement::attributes() const

Devuelve un 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 QDomNodeList que contiene todos los descendientes de este elemento llamado tagname encontrados durante un recorrido de preorden del subárbol de elementos con este elemento como raíz. El orden de los elementos en la lista devuelta es el orden en que se encuentran durante el recorrido de preorden.

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

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

Devuelve un QDomNodeList que contiene todos los descendientes de este elemento con nombre local localName y URI de espacio de nombres nsURI encontrados durante un recorrido de preorden del subárbol de elementos con este elemento como raíz. El orden de los elementos en la lista devuelta es el orden en que se encuentran durante el recorrido de 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. Como resultado, el nombre especificado se comprobará con nombres de atributo totalmente cualificados que incluyan cualquier prefijo de espacio de nombres que pueda estar presente.

Utilice hasAttributeNS() para buscar explícitamente 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 llamado nombre 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 valor value. Si existe un atributo con el mismo nombre, su valor se sustituye por value.

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