QXmlDeclHandler Class

Die Klasse QXmlDeclHandler bietet eine Schnittstelle zur Meldung des Deklarationsinhalts von XML-Daten. Mehr...

Kopfzeile: #include <QXmlDeclHandler>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake: QT += core5compat
Vererbt von:

QXmlDefaultHandler

Hinweis: Alle Funktionen in 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

Detaillierte Beschreibung

Sie können den Deklarationshandler mit QXmlReader::setDeclHandler() festlegen.

Diese Schnittstelle basiert auf der SAX2-Erweiterung DeclHandler.

Die Schnittstelle bietet die Funktionen attributeDecl(), internalEntityDecl() und externalEntityDecl().

Siehe auch QXmlDTDHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler, und QXmlLexicalHandler.

Dokumentation der Mitgliedsfunktionen

[virtual noexcept] QXmlDeclHandler::~QXmlDeclHandler()

Zerstört den Deklarationshandler.

[pure virtual] bool QXmlDeclHandler::attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value)

Der Leser ruft diese Funktion auf, um eine Attributtypdeklaration zu melden. Es wird nur die effektive (erste) Deklaration für ein Attribut gemeldet.

Der Leser übergibt den Namen des zugehörigen Elements in eName und den Namen des Attributs in aName. Er übergibt eine Zeichenkette, die den Attributtyp darstellt, in type und eine Zeichenkette, die den Attributstandard darstellt, in valueDefault. Dieser String ist einer von "#IMPLIED", "#REQUIRED", "#FIXED" oder ein leerer String (wenn keiner der anderen zutrifft). Der Reader übergibt den Standardwert des Attributs in value. Wenn in der XML-Datei kein Standardwert angegeben ist, ist value ein leerer String.

Wenn diese Funktion false zurückgibt, bricht der Reader das Parsen ab und meldet einen Fehler. Der Leser verwendet die Funktion errorString(), um die Fehlermeldung zu erhalten.

[pure virtual] QString QXmlDeclHandler::errorString() const

Der Leser ruft diese Funktion auf, um einen Fehlerstring zu erhalten, wenn eine der Handler-Funktionen false zurückgibt.

[pure virtual] bool QXmlDeclHandler::externalEntityDecl(const QString &name, const QString &publicId, const QString &systemId)

Der Leser ruft diese Funktion auf, um eine geparste externe Entitätserklärung zu melden. Es wird nur die effektive (erste) Deklaration für jede Entität gemeldet.

Der Leser übergibt den Namen der Entität in name, den öffentlichen Bezeichner in publicId und den Systembezeichner in systemId. Ist kein öffentlicher Bezeichner angegeben, wird ein leerer String in publicId übergeben.

Wenn diese Funktion false zurückgibt, bricht der Leser die Analyse ab und meldet einen Fehler. Der Leser verwendet die Funktion errorString(), um die Fehlermeldung zu erhalten.

[pure virtual] bool QXmlDeclHandler::internalEntityDecl(const QString &name, const QString &value)

Der Leser ruft diese Funktion auf, um eine interne Entitätserklärung zu melden. Es wird nur die effektive (erste) Deklaration gemeldet.

Der Leser übergibt den Namen der Entität in name und den Wert der Entität in value.

Wenn diese Funktion false zurückgibt, bricht der Leser das Parsen ab und meldet einen Fehler. Der Leser verwendet die Funktion errorString(), um die Fehlermeldung zu erhalten.

© 2025 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.