QXmlErrorHandler Class
Die Klasse „QXmlErrorHandler“ bietet eine Schnittstelle zur Meldung von Fehlern in XML-Daten. Mehr...
| Header: | #include <QXmlErrorHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake: | QT += core5compat |
| Vererbt an: |
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Funktionen
| virtual | ~QXmlErrorHandler() |
| virtual bool | error(const QXmlParseException &exception) = 0 |
| virtual QString | errorString() const = 0 |
| virtual bool | fatalError(const QXmlParseException &exception) = 0 |
| virtual bool | warning(const QXmlParseException &exception) = 0 |
Ausführliche Beschreibung
Wenn Ihre Anwendung Fehler an den Benutzer melden oder eine benutzerdefinierte Fehlerbehandlung durchführen soll, sollten Sie eine Unterklasse dieser Klasse erstellen.
Sie können den Fehlerbehandler mit ` QXmlReader::setErrorHandler()` festlegen.
Fehler können mit den Methoden „ warning()“, „ error()“ und „ fatalError()“ gemeldet werden, wobei der Fehlertext mit „ errorString()“ ausgegeben wird.
Siehe auch QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver und QXmlLexicalHandler.
Dokumentation zu den Member-Funktionen
[virtual noexcept] QXmlErrorHandler::~QXmlErrorHandler()
Löscht den Fehlerbehandler.
[pure virtual] bool QXmlErrorHandler::error(const QXmlParseException &exception)
Ein Leser kann diese Funktion verwenden, um einen behebbaren Fehler zu melden. Ein behebbarer Fehler entspricht der Definition von „Fehler“ in Abschnitt 1.2 der XML 1.0-Spezifikation. Details zum Fehler werden unter exception gespeichert.
Der Reader muss nach dem Aufruf dieser Funktion weiterhin normale Parsing-Ereignisse bereitstellen.
Wenn diese Funktion ` false ` zurückgibt, bricht der Reader das Parsen ab und meldet einen Fehler. Der Reader verwendet die Funktion ` errorString()` , um die Fehlermeldung abzurufen.
[pure virtual] QString QXmlErrorHandler::errorString() const
Der Leser ruft diese Funktion auf, um eine Fehlermeldung abzurufen, falls eine der Handler-Funktionen den Wert „ false “ zurückgibt.
[pure virtual] bool QXmlErrorHandler::fatalError(const QXmlParseException &exception)
Ein Leser muss diese Funktion verwenden, um einen nicht behebbaren Fehler zu melden. Details zum Fehler werden unter exception gespeichert.
Wenn diese Funktion „ true “ zurückgibt, versucht der Reader möglicherweise, die Analyse fortzusetzen und weitere Fehler zu melden, es werden jedoch keine regulären Analyseereignisse gemeldet.
[pure virtual] bool QXmlErrorHandler::warning(const QXmlParseException &exception)
Ein Reader kann diese Funktion verwenden, um eine Warnung zu melden. Warnungen sind Zustände, die gemäß der XML 1.0-Spezifikation weder Fehler noch schwerwiegende Fehler darstellen. Details zur Warnung werden in ` exception` gespeichert.
Wenn diese Funktion „ false “ zurückgibt, bricht der Reader die Analyse ab und meldet einen Fehler. Der Reader verwendet die Funktion „ errorString()“, um die Fehlermeldung abzurufen.
© 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.
