QXmlContentHandler Class
La clase QXmlContentHandler proporciona una interfaz para representar el contenido lógico de los datos XML. Más información...
| Encabezado: | #include <QXmlContentHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake: | QT += core5compat |
| Heredado por: |
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| virtual | ~QXmlContentHandler() |
| virtual bool | characters(const QString &ch) = 0 |
| virtual bool | endDocument() = 0 |
| virtual bool | endElement(const QString &namespaceURI, const QString &localName, const QString &qName) = 0 |
| virtual bool | endPrefixMapping(const QString &prefix) = 0 |
| virtual QString | errorString() const = 0 |
| virtual bool | ignorableWhitespace(const QString &ch) = 0 |
| virtual bool | processingInstruction(const QString &target, const QString &data) = 0 |
| virtual void | setDocumentLocator(QXmlLocator *locator) = 0 |
| virtual bool | skippedEntity(const QString &name) = 0 |
| virtual bool | startDocument() = 0 |
| virtual bool | startElement(const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts) = 0 |
| virtual bool | startPrefixMapping(const QString &prefix, const QString &uri) = 0 |
Descripción detallada
Si la aplicación necesita recibir información sobre eventos básicos de análisis sintáctico, puede implementar esta interfaz y activarla mediante ` QXmlReader::setContentHandler()`. De este modo, el lector puede notificar a través de esta interfaz eventos básicos relacionados con el documento, como el inicio y el final de elementos y datos de caracteres.
El orden de los eventos en esta interfaz es muy importante y refleja el orden de la información en el propio documento. Por ejemplo, todo el contenido de un elemento (datos de caracteres, instrucciones de procesamiento y subelementos) aparece, en orden, entre el evento ` startElement()` y el evento correspondiente ` endElement()`.
La clase QXmlDefaultHandler proporciona una implementación por defecto para esta interfaz; crear una subclase a partir de la clase QXmlDefaultHandler resulta muy práctico si solo se desea recibir información sobre determinados eventos de análisis sintáctico.
La función ` startDocument()` se invoca al inicio del documento, y ` endDocument()` se invoca al final. Antes de que comience el análisis, se invoca ` setDocumentLocator()`. Para cada elemento se invoca startElement(), y al final de cada elemento se invoca endElement(). La función characters() se invoca con fragmentos de datos de caracteres; ignorableWhitespace() se invoca con fragmentos de espacios en blanco y processingInstruction() se invoca con instrucciones de procesamiento. Si se omite una entidad, se invoca skippedEntity(). Al inicio de los ámbitos de URI de prefijo, se invoca startPrefixMapping().
Véase también QXmlDTDHandler, QXmlDeclHandler, QXmlEntityResolver, QXmlErrorHandler y QXmlLexicalHandler.
Documentación de funciones de miembro
[virtual noexcept] QXmlContentHandler::~QXmlContentHandler()
Elimina el gestor de contenidos.
[pure virtual] bool QXmlContentHandler::characters(const QString &ch)
El lector llama a esta función cuando ha analizado un fragmento de datos de caracteres (ya sean datos de caracteres normales o datos de caracteres dentro de una sección CDATA; si necesitas distinguir entre estos dos tipos, debes utilizar QXmlLexicalHandler::startCDATA() y QXmlLexicalHandler::endCDATA()). Los datos de caracteres se recogen en ch.
Algunos lectores informan de los espacios en blanco en el contenido de los elementos utilizando la función ignorableWhitespace() en lugar de esta.
Un lector puede informar de los datos de caracteres de un elemento en más de un fragmento; por ejemplo, un lector podría querer informar de «a<b» en tres eventos characters() («a », «<» y « b»).
Si esta función devuelve false, el lector detiene el análisis y notifica un error. El lector utiliza la función errorString() para obtener el mensaje de error.
[pure virtual] bool QXmlContentHandler::endDocument()
El lector llama a esta función una vez finalizado el análisis. Se llama solo una vez y es la última función de gestión que se ejecuta. Se llama después de que el lector haya leído toda la entrada o haya abandonado el análisis debido a un error grave.
Si esta función devuelve un valor de tipo « false », el lector detiene el análisis y notifica un error. El lector utiliza la función « errorString()» para obtener el mensaje de error.
Véase también startDocument().
[pure virtual] bool QXmlContentHandler::endElement(const QString &namespaceURI, const QString &localName, const QString &qName)
El lector llama a esta función cuando ha analizado una etiqueta de elemento final con el nombre calificado qName, el nombre local localName y el URI del espacio de nombres namespaceURI.
Si esta función devuelve « false », el lector detiene el análisis y notifica un error. El lector utiliza la función « errorString()» para obtener el mensaje de error.
Véase también startElement().
[pure virtual] bool QXmlContentHandler::endPrefixMapping(const QString &prefix)
El lector llama a esta función para indicar el final de una asignación de prefijo para el prefijo prefix.
Si esta función devuelve « false », el lector detiene el análisis y notifica un error. El lector utiliza la función « errorString()» para obtener el mensaje de error.
Véase también startPrefixMapping().
[pure virtual] QString QXmlContentHandler::errorString() const
El lector llama a esta función para obtener una cadena de error, por ejemplo, si alguna de las funciones de gestión devuelve « false ».
[pure virtual] bool QXmlContentHandler::ignorableWhitespace(const QString &ch)
Algunos lectores pueden utilizar esta función para informar de cada bloque de espacios en blanco presente en el contenido de un elemento. Los espacios en blanco se indican en ch.
Si esta función devuelve false, el lector detiene el análisis y notifica un error. El lector utiliza la función errorString() para obtener el mensaje de error.
[pure virtual] bool QXmlContentHandler::processingInstruction(const QString &target, const QString &data)
El lector llama a esta función cuando ha analizado una instrucción de procesamiento.
target es el nombre de destino de la instrucción de procesamiento y data son los datos contenidos en dicha instrucción.
Si esta función devuelve ` false `, el lector detiene el análisis y notifica un error. El lector utiliza la función ` errorString()` para obtener el mensaje de error.
[pure virtual] void QXmlContentHandler::setDocumentLocator(QXmlLocator *locator)
El lector llama a esta función antes de comenzar a analizar el documento. El argumento ` locator ` es un puntero a un ` QXmlLocator `, que permite a la aplicación obtener la posición de análisis dentro del documento.
No destruyas el ` locator`; este se destruye cuando se destruye el lector. (No utilices el ` locator ` una vez que se haya destruido el lector).
[pure virtual] bool QXmlContentHandler::skippedEntity(const QString &name)
Algunos lectores pueden omitir entidades si no han visto las declaraciones (por ejemplo, porque se encuentran en una DTD externa). Si lo hacen, informan de que han omitido la entidad denominada « name » llamando a esta función.
Si esta función devuelve « false », el lector detiene el análisis y notifica un error. El lector utiliza la función « errorString()» para obtener el mensaje de error.
[pure virtual] bool QXmlContentHandler::startDocument()
El lector llama a esta función cuando comienza a analizar el documento. El lector llama a esta función una sola vez, tras la llamada a ` setDocumentLocator()` y antes de que se llamen otras funciones de esta clase o de la clase ` QXmlDTDHandler `.
Si esta función devuelve false, el lector detiene el análisis y notifica un error. El lector utiliza la función errorString() para obtener el mensaje de error.
Véase también endDocument().
[pure virtual] bool QXmlContentHandler::startElement(const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts)
El lector llama a esta función cuando ha analizado una etiqueta de inicio de elemento.
Existe una llamada correspondiente a ` endElement()` cuando se lee la etiqueta de fin de elemento correspondiente. Las llamadas a `startElement()` y ` endElement()` siempre están anidadas correctamente. Las etiquetas de elemento vacías (p. ej., ` <x/>`) hacen que una llamada a `startElement()` vaya seguida inmediatamente de una llamada a ` endElement()`.
La lista de atributos proporcionada solo contiene atributos con valores explícitos. La lista de atributos contiene atributos utilizados para la declaración de espacios de nombres (es decir, atributos que comienzan por xmlns) únicamente si la propiedad namespace-prefix del lector es verdadera.
El argumento ` namespaceURI ` es el URI del espacio de nombres, o una cadena vacía si el elemento no tiene URI de espacio de nombres o si no se realiza ningún procesamiento de espacios de nombres. ` localName ` es el nombre local (sin prefijo), o una cadena vacía si no se realiza ningún procesamiento de espacios de nombres; ` qName ` es el nombre calificado (con prefijo) y ` atts ` son los atributos asociados al elemento. Si no hay atributos, atts es un objeto de atributos vacío.
Si esta función devuelve « false », el lector detiene el análisis y notifica un error. El lector utiliza la función « errorString()» para obtener el mensaje de error.
Véase también endElement().
[pure virtual] bool QXmlContentHandler::startPrefixMapping(const QString &prefix, const QString &uri)
El lector invoca esta función para indicar el inicio de un ámbito de asignación de prefijos a URI de espacio de nombres. Esta información no es necesaria para el procesamiento normal de los espacios de nombres, ya que el lector sustituye automáticamente los prefijos de los nombres de elementos y atributos.
Tenga en cuenta que no se garantiza que las llamadas a `startPrefixMapping()` y ` endPrefixMapping()` estén correctamente anidadas entre sí: todos los eventos de `startPrefixMapping()` se producen antes del evento correspondiente de ` startElement()`, y todos los eventos de ` endPrefixMapping()` se producen después del evento correspondiente de ` endElement()`, pero su orden no está garantizado en ningún otro sentido.
El argumento prefix es el prefijo del espacio de nombres que se está declarando y el argumento uri es el URI del espacio de nombres al que se asigna el prefijo.
Si esta función devuelve false, el lector detiene el análisis y notifica un error. El lector utiliza la función errorString() para obtener el mensaje de error.
Véase también endPrefixMapping().
© 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.