このページでは

QXmlDeclHandler Class

QXmlDeclHandler クラスは、XML データの宣言内容を報告するためのインターフェースを提供します。詳細...

ヘッダー: #include <QXmlDeclHandler>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake: QT += core5compat
継承元:

QXmlDefaultHandler

注:このクラスのすべての関数は再入可能である。

パブリック関数

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

詳細な説明

QXmlReader::setDeclHandler() を使用して、宣言ハンドラを設定できます。

このインターフェースは、SAX2 拡張の DeclHandler に基づいています。

このインターフェースは、attributeDecl()、internalEntityDecl()、およびexternalEntityDecl() 関数を提供します。

QXmlDTDHandler 、QXmlContentHandler 、QXmlEntityResolver 、QXmlErrorHandler 、およびQXmlLexicalHandlerも参照してください 。

メンバ関数のドキュメント

[virtual noexcept] QXmlDeclHandler::~QXmlDeclHandler()

宣言ハンドラを破棄します。

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

リーダーはこの関数を呼び出して、属性型の宣言を報告します。属性については、有効な(最初の)宣言のみが報告されます。

リーダーは、eName に関連する要素の名前を、aName に属性の名前を渡します。また、type に属性型を表す文字列を、valueDefault に属性のデフォルト値を表す文字列を渡します。 この文字列は、「#IMPLIED」、「#REQUIRED」、「#FIXED」のいずれか、または(他のいずれにも該当しない場合は)空文字列となります。リーダーは、value を通じて属性のデフォルト値を渡します。XML ファイルにデフォルト値が指定されていない場合、value は空文字列となります。

この関数がfalse を返した場合、リーダーは解析を中止し、エラーを報告します。リーダーはerrorString()関数を使用してエラーメッセージを取得します。

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

ハンドラ関数のいずれかがfalse を返した場合、リーダーはこの関数を呼び出してエラー文字列を取得します。

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

リーダーは、解析済みの外部エンティティ宣言を報告するためにこの関数を呼び出します。各エンティティについて、有効な(最初の)宣言のみが報告されます。

リーダーは、name にエンティティ名を、publicId にパブリック識別子を、systemId にシステム識別子を渡します。パブリック識別子が指定されていない場合は、publicId に空の文字列を渡します。

この関数がfalse を返した場合、リーダーは解析を中止し、エラーを報告します。リーダーは関数errorString()を使用してエラーメッセージを取得します。

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

リーダーはこの関数を呼び出して、内部エンティティの宣言を報告します。有効な(最初の)宣言のみが報告されます。

リーダーは、name にエンティティの名前を、value にエンティティの値を渡します。

この関数が `false ` を返した場合、リーダーは解析を中止し、エラーを報告します。リーダーは関数 `errorString()` を使用してエラーメッセージを取得します。

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