QXmlErrorHandler Class
La classe QXmlErrorHandler fournit une interface permettant de signaler les erreurs dans les données XML. En savoir plus...
| En-tête : | #include <QXmlErrorHandler> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake : | QT += core5compat |
| Hérité par : |
Remarque : toutes les fonctions de cette classe sont réentrantes.
Fonctions publiques
| 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 |
Description détaillée
Si vous souhaitez que votre application signale les erreurs à l'utilisateur ou qu'elle effectue une gestion personnalisée des erreurs, vous devez créer une sous-classe de cette classe.
Vous pouvez définir le gestionnaire d'erreurs à l'aide de la fonction QXmlReader::setErrorHandler().
Les erreurs peuvent être signalées à l’aide des méthodes ` warning()`, ` error()` et ` fatalError()`, le texte de l’erreur étant renvoyé par la méthode ` errorString()`.
Voir également QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver et QXmlLexicalHandler.
Documentation sur les fonctions membres
[virtual noexcept] QXmlErrorHandler::~QXmlErrorHandler()
Supprime le gestionnaire d'erreurs.
[pure virtual] bool QXmlErrorHandler::error(const QXmlParseException &exception)
Un lecteur peut utiliser cette fonction pour signaler une erreur récupérable. Une erreur récupérable correspond à la définition du terme « erreur » donnée à la section 1.2 de la spécification XML 1.0. Les détails de l'erreur sont stockés dans ` exception`.
Le lecteur doit continuer à fournir des événements d’analyse syntaxique normaux après avoir appelé cette fonction.
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] QString QXmlErrorHandler::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 QXmlErrorHandler::fatalError(const QXmlParseException &exception)
Un lecteur doit utiliser cette fonction pour signaler une erreur irrémédiable. Les détails de l'erreur sont stockés dans exception.
Si cette fonction renvoie ` true `, le lecteur peut tenter de poursuivre l'analyse et de signaler d'autres erreurs, mais aucun événement d'analyse standard n'est signalé.
[pure virtual] bool QXmlErrorHandler::warning(const QXmlParseException &exception)
Un lecteur peut utiliser cette fonction pour signaler un avertissement. Les avertissements correspondent à des conditions qui ne sont ni des erreurs ni des erreurs fatales, telles que définies par la spécification XML 1.0. Les détails de l'avertissement sont stockés dans ` exception`.
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.
© 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.
