QXmlLexicalHandler Class
La classe QXmlLexicalHandler fournit une interface pour signaler le contenu lexical des données XML. Plus d'informations...
| En-tête : | #include <QXmlLexicalHandler> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core5Compat)target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake : | QT += core5compat |
| Inherited By : |
Note : Toutes les fonctions de cette classe sont réentrantes.
Fonctions publiques
| virtual | ~QXmlLexicalHandler() |
| virtual bool | comment(const QString &ch) = 0 |
| virtual bool | endCDATA() = 0 |
| virtual bool | endDTD() = 0 |
| virtual bool | endEntity(const QString &name) = 0 |
| virtual QString | errorString() const = 0 |
| virtual bool | startCDATA() = 0 |
| virtual bool | startDTD(const QString &name, const QString &publicId, const QString &systemId) = 0 |
| virtual bool | startEntity(const QString &name) = 0 |
Description détaillée
Les événements du gestionnaire lexical s'appliquent à l'ensemble du document, et pas seulement à l'élément document, et tous les événements du gestionnaire lexical apparaissent entre les événements startDocument et endDocument du gestionnaire de contenu.
Vous pouvez définir le gestionnaire lexical à l'aide de QXmlReader::setLexicalHandler().
La conception de cette interface est basée sur l'extension SAX2 LexicalHandler.
L'interface fournit les fonctions startDTD(), endDTD(), startEntity(), endEntity(), startCDATA(), endCDATA() et comment().
Voir aussi QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, et QXmlErrorHandler.
Documentation des fonctions membres
[virtual noexcept] QXmlLexicalHandler::~QXmlLexicalHandler()
Détruit le gestionnaire lexical.
[pure virtual] bool QXmlLexicalHandler::comment(const QString &ch)
Le lecteur appelle cette fonction pour signaler un commentaire XML n'importe où dans le document. Il signale le texte du commentaire dans ch.
Si cette fonction renvoie false, le lecteur arrête l'analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour obtenir le message d'erreur.
[pure virtual] bool QXmlLexicalHandler::endCDATA()
Le lecteur appelle cette fonction pour signaler la fin d'une section CDATA.
Si cette fonction renvoie false, le lecteur arrête l'analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour obtenir le message d'erreur.
Voir aussi startCDATA() et QXmlContentHandler::characters().
[pure virtual] bool QXmlLexicalHandler::endDTD()
Le lecteur appelle cette fonction pour signaler la fin d'une déclaration DTD, le cas échéant.
Si cette fonction renvoie false, le lecteur arrête l'analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour obtenir le message d'erreur.
Voir aussi startDTD().
[pure virtual] bool QXmlLexicalHandler::endEntity(const QString &name)
Le lecteur appelle cette fonction pour signaler la fin d'une entité appelée name.
Pour chaque appel à startEntity(), il existe un appel correspondant à endEntity(). Les appels à startEntity() et endEntity() sont correctement imbriqués.
Si cette fonction renvoie false, le lecteur arrête l'analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour obtenir le message d'erreur.
Voir également startEntity(), QXmlContentHandler::skippedEntity() et QXmlSimpleReader::setFeature().
[pure virtual] QString QXmlLexicalHandler::errorString() const
Le lecteur appelle cette fonction pour obtenir une chaîne d'erreur si l'une des fonctions de traitement renvoie false.
[pure virtual] bool QXmlLexicalHandler::startCDATA()
Le lecteur appelle cette fonction pour signaler le début d'une section CDATA. Le contenu de la section CDATA est signalé par la fonction QXmlContentHandler::characters(). Cette fonction n'est destinée qu'à signaler la limite.
Si cette fonction renvoie false, le lecteur arrête l'analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour obtenir le message d'erreur.
Voir également endCDATA().
[pure virtual] bool QXmlLexicalHandler::startDTD(const QString &name, const QString &publicId, const QString &systemId)
Le lecteur appelle cette fonction pour signaler le début d'une déclaration DTD, le cas échéant. Il signale le nom du type de document dans name, l'identifiant public dans publicId et l'identifiant du système dans systemId.
Si l'identificateur public est manquant, publicId est défini comme une chaîne vide. Si l'identifiant du système est manquant, systemId est défini comme une chaîne vide. Notez que ce n'est pas un XML valide d'avoir un identifiant public mais pas d'identifiant de système ; dans ce cas, une erreur d'analyse se produira.
Toutes les déclarations signalées par QXmlDTDHandler ou QXmlDeclHandler apparaissent entre les appels startDTD() et endDTD().
Si cette fonction renvoie false, le lecteur arrête l'analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour obtenir le message d'erreur.
Voir aussi endDTD().
[pure virtual] bool QXmlLexicalHandler::startEntity(const QString &name)
Le lecteur appelle cette fonction pour signaler le début d'une entité appelée name.
Notez que si l'entité est inconnue, le lecteur la signale via QXmlContentHandler::skippedEntity() et non via cette fonction.
Si cette fonction renvoie false, le lecteur arrête l'analyse et signale une erreur. Le lecteur utilise la fonction errorString() pour obtenir le message d'erreur.
Voir également endEntity() et QXmlSimpleReader::setFeature().
© 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.