Класс QXmlDeclHandler

Класс QXmlDeclHandler предоставляет интерфейс для отчёта о содержимом объявления XML-данных. Подробнее...

• Список всех членов, включая наследуемые

Примечание: Все функции в этом классе являются перевходоспособными.

Открытые функции

Подробное описание

Класс QXmlDeclHandler предоставляет интерфейс для отчёта о содержимом объявления XML-данных.

Вы можете установить обработчик объявлений с помощью QXmlReader::setDeclHandler().

Этот интерфейс основан на расширении SAX2 DeclHandler.

Интерфейс предоставляет функции attributeDecl(), internalEntityDecl() и externalEntityDecl().

См. также QXmlDTDHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler, QXmlLexicalHandler и Введение в SAX2.

Документация по функциям-членам

[virtual] 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() для получения сообщения об ошибке.