QXmlDeclHandler Class
Die Klasse „QXmlDeclHandler“ bietet eine Schnittstelle zur Darstellung des Deklarationsinhalts von XML-Daten. Mehr...
| Header: | #include <QXmlDeclHandler> |
| 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 | ~QXmlDeclHandler() |
| virtual bool | attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value) = 0 |
| virtual QString | errorString() const = 0 |
| virtual bool | externalEntityDecl(const QString &name, const QString &publicId, const QString &systemId) = 0 |
| virtual bool | internalEntityDecl(const QString &name, const QString &value) = 0 |
Ausführliche Beschreibung
Sie können den Deklarationshandler mit ` QXmlReader::setDeclHandler()` festlegen.
Diese Schnittstelle basiert auf der SAX2-Erweiterung „DeclHandler“.
Die Schnittstelle stellt die Funktionen „ attributeDecl()“, „ internalEntityDecl()“ und „ externalEntityDecl()“ bereit.
Siehe auch „ QXmlDTDHandler“ , „ QXmlContentHandler “, „ QXmlEntityResolver “, „ QXmlErrorHandler “ und „ QXmlLexicalHandler “.
Dokumentation zu Mitgliedsfunktionen
[virtual noexcept] QXmlDeclHandler::~QXmlDeclHandler()
Löscht den Deklarations-Handler.
[pure virtual] bool QXmlDeclHandler::attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value)
Der Reader ruft diese Funktion auf, um eine Attributtyp-Deklaration zu melden. Es wird nur die gültige (erste) Deklaration für ein Attribut gemeldet.
Der Reader übergibt den Namen des zugehörigen Elements in ` eName ` und den Namen des Attributs in ` aName`. Er übergibt eine Zeichenkette, die den Attributtyp repräsentiert, in ` type ` und eine Zeichenkette, die den Attributstandardwert repräsentiert, in ` valueDefault`. Diese Zeichenkette ist entweder „#IMPLIED“, „#REQUIRED“, „#FIXED“ oder eine leere Zeichenkette (falls keine der anderen zutrifft). Der Reader übergibt den Standardwert des Attributs in value. Ist in der XML-Datei kein Standardwert angegeben, ist value eine leere Zeichenkette.
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.
[pure virtual] QString QXmlDeclHandler::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 QXmlDeclHandler::externalEntityDecl(const QString &name, const QString &publicId, const QString &systemId)
Der Reader ruft diese Funktion auf, um eine geparste Deklaration einer externen Entität zu melden. Es wird jeweils nur die gültige (erste) Deklaration für jede Entität gemeldet.
Der Reader übergibt den Namen der Entität in ` name`, den öffentlichen Bezeichner in ` publicId ` und den Systembezeichner in ` systemId`. Wenn kein öffentlicher Bezeichner angegeben ist, übergibt er eine leere Zeichenkette in ` publicId`.
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.
[pure virtual] bool QXmlDeclHandler::internalEntityDecl(const QString &name, const QString &value)
Der Reader ruft diese Funktion auf, um eine interne Entitätsdeklaration zu melden. Es wird nur die gültige (erste) Deklaration gemeldet.
Der Reader übergibt den Namen der Entität in „ name “ und den Wert der Entität in „ value “.
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.