QXmlDefaultHandler Class
La clase QXmlDefaultHandler ofrece una implementación predeterminada de todas las clases de controladores XML. Más información...
| Encabezado: | #include <QXmlDefaultHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake: | QT += core5compat |
| Heredado de: | QXmlContentHandler, QXmlErrorHandler, QXmlDTDHandler, QXmlEntityResolver, QXmlLexicalHandler y QXmlDeclHandler |
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| QXmlDefaultHandler() | |
| virtual | ~QXmlDefaultHandler() |
Funciones públicas reimplementadas
| virtual bool | attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value) override |
| virtual bool | characters(const QString &ch) override |
| virtual bool | comment(const QString &ch) override |
| virtual bool | endCDATA() override |
| virtual bool | endDTD() override |
| virtual bool | endDocument() override |
| virtual bool | endElement(const QString &namespaceURI, const QString &localName, const QString &qName) override |
| virtual bool | endEntity(const QString &name) override |
| virtual bool | endPrefixMapping(const QString &prefix) override |
| virtual bool | error(const QXmlParseException &exception) override |
| virtual QString | errorString() const override |
| virtual bool | externalEntityDecl(const QString &name, const QString &publicId, const QString &systemId) override |
| virtual bool | fatalError(const QXmlParseException &exception) override |
| virtual bool | ignorableWhitespace(const QString &ch) override |
| virtual bool | internalEntityDecl(const QString &name, const QString &value) override |
| virtual bool | notationDecl(const QString &name, const QString &publicId, const QString &systemId) override |
| virtual bool | processingInstruction(const QString &target, const QString &data) override |
| virtual bool | resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource *&ret) override |
| virtual void | setDocumentLocator(QXmlLocator *locator) override |
| virtual bool | skippedEntity(const QString &name) override |
| virtual bool | startCDATA() override |
| virtual bool | startDTD(const QString &name, const QString &publicId, const QString &systemId) override |
| virtual bool | startDocument() override |
| virtual bool | startElement(const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts) override |
| virtual bool | startEntity(const QString &name) override |
| virtual bool | startPrefixMapping(const QString &prefix, const QString &uri) override |
| virtual bool | unparsedEntityDecl(const QString &name, const QString &publicId, const QString &systemId, const QString ¬ationName) override |
| virtual bool | warning(const QXmlParseException &exception) override |
Descripción detallada
Esta clase reúne las características de las clases de controladores especializadas, lo que la convierte en un punto de partida práctico a la hora de implementar controladores personalizados para subclases de ` QXmlReader`, en particular ` QXmlSimpleReader`. Las funciones virtuales de cada una de las clases base se reimplementan en esta clase, lo que proporciona un comportamiento predeterminado adecuado para muchos casos habituales. Al crear una subclase de esta clase y sobrescribir estas funciones, podrás centrarte en implementar las partes del controlador relevantes para tu aplicación.
Es necesario indicar al lector de XML qué controlador debe utilizarse para los diferentes tipos de eventos durante el análisis. Esto significa que, aunque `QXmlDefaultHandler` proporciona implementaciones por defecto de las funciones heredadas de todas sus clases base, aún así podemos utilizar controladores especializados para tipos concretos de eventos.
Por ejemplo, `QXmlDefaultHandler` es una subclase tanto de ` QXmlContentHandler ` como de ` QXmlErrorHandler`, por lo que, al crear una subclase de esta, podemos utilizar el mismo controlador para las dos funciones de lectura siguientes:
xmlReader.setContentHandler(handler);
xmlReader.setErrorHandler(handler);Dado que el lector informará al controlador de los errores de análisis, es necesario reimplementar ` QXmlErrorHandler::fatalError()` si, por ejemplo, queremos detener el análisis cuando se produzca dicho error:
bool Handler::fatalError (const QXmlParseException& exception)
{
qWarning() << "Fatal error on line" << exception.lineNumber()
<< ", columna" << exception.columnNumber() << ':'
<< exception.message();
return false;
}La función anterior devuelve ` false`, lo que indica al lector que deje de analizar. Para seguir utilizando el mismo lector, es necesario crear una nueva instancia del controlador y configurar el lector para que la utilice tal y como se ha descrito anteriormente.
Resulta útil examinar algunas de las funciones heredadas por `QXmlDefaultHandler` y plantearse por qué podrían reimplementarse en un controlador personalizado. Los controladores personalizados suelen reimplementar ` QXmlContentHandler::startDocument()` para preparar el controlador para el nuevo contenido. Los elementos del documento y el texto que contienen pueden procesarse reimplementando QXmlContentHandler::startElement(), QXmlContentHandler::endElement() y QXmlContentHandler::characters(). Es posible que desee reimplementar QXmlContentHandler::endDocument() para realizar alguna tarea de finalización o validación del contenido una vez que el documento se haya leído por completo.
Véase también QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler y QXmlLexicalHandler.
Documentación de funciones de miembro
QXmlDefaultHandler::QXmlDefaultHandler()
Crea un controlador para su uso con subclases de ` QXmlReader`.
[virtual noexcept] QXmlDefaultHandler::~QXmlDefaultHandler()
Elimina el controlador.
[override virtual] bool QXmlDefaultHandler::attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value)
Reimplementa: QXmlDeclHandler::attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value).
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::characters(const QString &ch)
Reimplementa: ` QXmlContentHandler::characters(const QString &ch)`.
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::comment(const QString &ch)
Reimplementa: ` QXmlLexicalHandler::comment(const QString &ch)`.
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::endCDATA()
Reimplementa: QXmlLexicalHandler::endCDATA().
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::endDTD()
Reimplementa: QXmlLexicalHandler::endDTD().
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::endDocument()
Reimplementa: QXmlContentHandler::endDocument().
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::endElement(const QString &namespaceURI, const QString &localName, const QString &qName)
Reimplementa: ` QXmlContentHandler::endElement` (`const QString &namespaceURI, const QString &localName, const QString &qName`).
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::endEntity(const QString &name)
Reimplementa: ` QXmlLexicalHandler::endEntity(const QString &name)`.
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::endPrefixMapping(const QString &prefix)
Reimplementa: QXmlContentHandler::endPrefixMapping(const QString &prefix).
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::error(const QXmlParseException &exception)
Reimplementa: QXmlErrorHandler::error(const QXmlParseException &exception).
Esta reimplementación no hace nada.
[override virtual] QString QXmlDefaultHandler::errorString() const
Reimplementa: ` QXmlContentHandler::errorString()` const.
Devuelve la cadena de error predeterminada.
[override virtual] bool QXmlDefaultHandler::externalEntityDecl(const QString &name, const QString &publicId, const QString &systemId)
Reimplementa: ` QXmlDeclHandler::externalEntityDecl` (`const QString &name`, `const QString &publicId`, `const QString &systemId`).
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::fatalError(const QXmlParseException &exception)
Reimplementa: QXmlErrorHandler::fatalError(const QXmlParseException &exception).
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::ignorableWhitespace(const QString &ch)
Reimplementa: ` QXmlContentHandler::ignorableWhitespace(const QString &ch)`.
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::internalEntityDecl(const QString &name, const QString &value)
Reimplementa: ` QXmlDeclHandler::internalEntityDecl` (const QString &name, const QString &value).
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::notationDecl(const QString &name, const QString &publicId, const QString &systemId)
Reimplementa: ` QXmlDTDHandler::notationDecl(const QString &name, const QString &publicId, const QString &systemId)`.
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::processingInstruction(const QString &target, const QString &data)
Reimplementa: ` QXmlContentHandler::processingInstruction(const QString &target, const QString &data)`.
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource *&ret)
Reimplementa: QXmlEntityResolver::resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource *&ret).
Establece ` ret ` en ` nullptr`, de modo que el lector utilice el identificador del sistema proporcionado en el documento XML.
[override virtual] void QXmlDefaultHandler::setDocumentLocator(QXmlLocator *locator)
Reimplementa: ` QXmlContentHandler::setDocumentLocator(QXmlLocator *locator)`.
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::skippedEntity(const QString &name)
Reimplementa: ` QXmlContentHandler::skippedEntity(const QString &name)`.
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::startCDATA()
Reimplementa: QXmlLexicalHandler::startCDATA().
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::startDTD(const QString &name, const QString &publicId, const QString &systemId)
Reimplementa: QXmlLexicalHandler::startDTD(const QString &name, const QString &publicId, const QString &systemId).
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::startDocument()
Reimplementa: QXmlContentHandler::startDocument().
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::startElement(const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts)
Reimplementa: ` QXmlContentHandler::startElement` (`const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts`).
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::startEntity(const QString &name)
Reimplementa: QXmlLexicalHandler::startEntity(const QString &name).
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::startPrefixMapping(const QString &prefix, const QString &uri)
Reimplementa: ` QXmlContentHandler::startPrefixMapping(const QString &prefix, const QString &uri)`.
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::unparsedEntityDecl(const QString &name, const QString &publicId, const QString &systemId, const QString ¬ationName)
Reimplementa: ` QXmlDTDHandler::unparsedEntityDecl` (`const QString &name`, `const QString &publicId`, `const QString &systemId`, `const QString ¬ationName`).
Esta reimplementación no hace nada.
[override virtual] bool QXmlDefaultHandler::warning(const QXmlParseException &exception)
Reimplementa: QXmlErrorHandler::warning(const QXmlParseException &exception).
Esta reimplementación no hace nada.
© 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.