Описание класса QXmlLexicalHandler
[модуль QtXml]
Класс QXmlLexicalHandler обеспечивает интерфейс для сообщения о лексическом содержании XML данных. Далее...
#include <QXmlLexicalHandler> Унаследован от QXmlDefaultHandler.
Замечание: все функции этого класса реентерабильны.
Открытые функции
Подробное описание
Класс QXmlLexicalHandler обеспечивает интерфейс для сообщения о лексическом содержании XML данных.
События лексического обработчика применяются ко всему документу, а не только к элементы и появляются между событиями startDocument и endDocument
Вы можете установить лексический обработчик с помощью QXmlReader::setLexicalHandler().
Дизайн интерфейса основывается на SAX2 расширении LexicalHandler.
Интерфейс обеспечивает функции startDTD(), endDTD(), startEntity(), endEntity(), startCDATA(), endCDATA() и comment().
Смотрите также QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler и Introduction to SAX2.
Описание функций-членов
QXmlLexicalHandler::~QXmlLexicalHandler () [virtual]
Уничтожает лексический обработчик.
bool QXmlLexicalHandler::comment ( const QString & ch ) [pure virtual]
Читатель вызывает эту функцию для сообщения о XML комментарии, расположенном где-то в документе. Текст комментария передается в ch.
Если эта функция вернула false, чтение останавливается, сообщается об ошибке. Функция errorString() используется для получения сообщения об ошибке.
bool QXmlLexicalHandler::endCDATA () [pure virtual]
Читатель вызывает эту функцию для сообщения о CDATA области.
Если эта функция вернула false, чтение останавливается, сообщается об ошибке. Функция errorString() используется для получения сообщения об ошибке.
Смотрите также startCDATA() и QXmlContentHandler::characters().
bool QXmlLexicalHandler::endDTD () [pure virtual]
Читатель вызывает эту функцию для сообщения о декларации DTD, если она встретилась при чтении.
Если эта функция вернула false, чтение останавливается, сообщается об ошибке. Функция errorString() используется для получения сообщения об ошибке.
Смотрите также startDTD().
bool QXmlLexicalHandler::endEntity ( const QString & name ) [pure virtual]
Читатель вызывает эту функцию для сообщения об окончании сущности с именем name.
Для каждого вызова startEntity(), существует связанный вызов endEntity(). Вызовы startEntity() и endEntity() являются вложенными.
Если эта функция вернула false, чтение останавливается, сообщается об ошибке. Функция errorString() используется для получения сообщения об ошибке.
Смотрите также startEntity(), QXmlContentHandler::skippedEntity() и QXmlSimpleReader::setFeature().
QString QXmlLexicalHandler::errorString () const [pure virtual]
Эта функция вызывается для получения строки ошибок, если какая-либо функция обработки вернула false.
bool QXmlLexicalHandler::startCDATA () [pure virtual]
Читатель вызывает эту функцию для сообщения о начале CDATA области. Содержимое CDATA области передаётся с помощью функции QXmlContentHandler::characters(). Эта функция только сообщает о событии.
Если эта функция вернула false, чтение останавливается, сообщается об ошибке. Функция errorString() используется для получения сообщения об ошибке.
Смотрите также endCDATA().
bool QXmlLexicalHandler::startDTD ( const QString & name, const QString & publicId, const QString & systemId ) [pure virtual]
Читатель вызывает эту функцию для сообщения о начале декларации DTD, если она встретилась. Сообщается имя типа документа в name, открытый идентификатор в publicId и системный идентификатор systemId.
Если открытый идентификатор пропущен, publicId равен пустой строке. Если системный идентификатор пропущен, systemId равен пустой строке. Помните, что XML, имеющий открытый идентификатор, но не имеющий системного, является невалидным; в этом случае анализатор сообщит об ошибке.
О всех декларациях сообщается через QXmlDTDHandler или QXmlDeclHandler, возникающими между вызовами startDTD() и endDTD().
Если эта функция вернула false, чтение останавливается, сообщается об ошибке. Функция errorString() используется для получения сообщения об ошибке.
Смотрите также endDTD().
bool QXmlLexicalHandler::startEntity ( const QString & name ) [pure virtual]
Читатель вызывает эту функцию для сообщения о начале сущности с именем name.
Помните, что если сущность является неопознанной, читатель сообщит об этом с помощью QXmlContentHandler::skippedEntity() и не будет обрабатывать её этой функцией.
Если эта функция вернула false, чтение останавливается, сообщается об ошибке. Функция errorString() используется для получения сообщения об ошибке.
Смотрите также endEntity() и QXmlSimpleReader::setFeature().
| 
