Sur cette page

QXmlDeclHandler Class

La classe QXmlDeclHandler fournit une interface permettant de signaler le contenu des déclarations des données XML. En savoir plus...

En-tête : #include <QXmlDeclHandler>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake : QT += core5compat
Hérité par :

QXmlDefaultHandler

Remarque : toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

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

Description détaillée

Vous pouvez définir le gestionnaire de déclaration à l’aide de la fonction ` QXmlReader::setDeclHandler()`.

Cette interface s’appuie sur l’extension DeclHandler de SAX2.

L’interface fournit les fonctions attributeDecl(), internalEntityDecl() et externalEntityDecl().

Voir également QXmlDTDHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler et QXmlLexicalHandler.

Documentation sur les fonctions membres

[virtual noexcept] QXmlDeclHandler::~QXmlDeclHandler()

Supprime le gestionnaire de déclaration.

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

Le lecteur appelle cette fonction pour signaler la déclaration d'un type d'attribut. Seule la déclaration effective (la première) d'un attribut est signalée.

Le lecteur transmet le nom de l'élément associé dans ` eName ` et le nom de l'attribut dans ` aName`. Il transmet une chaîne représentant le type de l'attribut dans ` type ` et une chaîne représentant la valeur par défaut de l'attribut dans ` valueDefault`. Cette chaîne de caractères est l’une des suivantes : « #IMPLIED », « #REQUIRED », « #FIXED » ou une chaîne vide (si aucune des autres ne s’applique). Le lecteur transmet la valeur par défaut de l’attribut dans value. Si aucune valeur par défaut n’est spécifiée dans le fichier XML, value est une chaîne vide.

Si cette fonction renvoie « false », le lecteur interrompt l’analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour récupérer le message d’erreur.

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

Le lecteur appelle cette fonction pour obtenir une chaîne d'erreur si l'une des fonctions de gestion renvoie la valeur « false ».

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

Le lecteur appelle cette fonction pour signaler une déclaration d'entité externe analysée. Seule la déclaration effective (la première) de chaque entité est signalée.

Le lecteur transmet le nom de l’entité dans ` name`, l’identificateur public dans ` publicId ` et l’identificateur système dans ` systemId`. Si aucun identificateur public n’est spécifié, il transmet une chaîne vide dans ` publicId`.

Si cette fonction renvoie « false », le lecteur interrompt l’analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour obtenir le message d’erreur.

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

Le lecteur appelle cette fonction pour signaler une déclaration d'entité interne. Seule la déclaration effective (la première) est signalée.

Le lecteur transmet le nom de l’entité dans name et la valeur de l’entité dans value.

Si cette fonction renvoie false, le lecteur interrompt l'analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour obtenir le message d'erreur.

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