Класс QAbstractMessageHandler

Класс QAbstractMessageHandler предоставляет интерфейс обратного вызова для обработки сообщений. Подробнее...

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

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

• 32 открытых функций унаследовано от QObject

Защищенные функции

• 9 защищенных функций унаследовано от QObject

Дополнительные унаследованные члены

• 1 свойство унаследовано от QObject
• 1 открытый слот унаследован от QObject
• 2 сигнала унаследованы от QObject
• 11 статических открытых членов унаследовано от QObject

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

Класс QAbstractMessageHandler предоставляет интерфейс обратного вызова для обработки сообщений.

QAbstractMessageHandler — это абстрактный базовый класс, предоставляющий интерфейс обратного вызова для обработки сообщений. Например, класс QXmlQuery парсит и выполняет запрос XQuery. При обнаружении ошибки компиляции или выполнения он генерирует соответствующее сообщение об ошибке, но вместо вывода сообщения сам передает сообщение в функцию message() своего объекта QAbstractMessageHandler. См. QXmlQuery::setMessageHandler().

Вы создаете обработчик сообщений, наследуя класс QAbstractMessageHandler и реализуя функцию handleMessage(). Затем передаете указатель на экземпляр своего подкласса любым классам, которые должны генерировать сообщения. Сообщения отправляются обработчику сообщений через функцию message(), которая передает их в вашу функцию handleMessge().

Один экземпляр QAbstractMessageHandler может использоваться для обработки сообщений из нескольких источников. Следовательно, содержимое сообщения, которое является параметром description, передаваемым в message() и handleMessage(), должно интерпретироваться в контексте, потребовавшем отправки сообщения. Этот контекст задается параметрами identifier и sourceLocation функции message() handleMessage().

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

QAbstractMessageHandler::QAbstractMessageHandler(QObject *parent = Q_NULLPTR)

Конструирует QAbstractMessageHandler. Параметр parent передаётся конструктору базового класса QObject.

[virtual] QAbstractMessageHandler::~QAbstractMessageHandler()

Деструктор QAbstractMessageHandler.

[pure virtual protected] void QAbstractMessageHandler::handleMessage(QtMsgType type, const QString &description, const QUrl &identifier, const QSourceLocation &sourceLocation)

Эта функция должна быть реализована подклассом. message() вызовет эту функцию, передав свои параметры type, description, identifier и sourceLocation без изменений.

Эта функция потенциально может вызываться из нескольких потоков. Ответственность за обеспечение безопасности потоков лежит на реализации подкласса.

void QAbstractMessageHandler::message(QtMsgType type, const QString &description, const QUrl &identifier = QUrl(), const QSourceLocation &sourceLocation = QSourceLocation())

Отправляет сообщение этому обработчику. type — это тип отправляемого сообщения. description — содержимое сообщения. identifier — URI, идентифицирующий сообщение и являющийся ключом к интерпретации других аргументов.

Как правило, этот класс используется для сообщения об ошибках, как в случае с QXmlQuery, который использует QAbstractMessageHandler для сообщения об ошибках компиляции и выполнения XQuery. Поэтому использование QUrl в качестве идентификатора сообщения было вдохновлено объяснением обработки ошибок в языке XQuery. Поскольку identifier состоит из URI пространства имён и локальной части, идентификаторы с одинаковой локальной частью уникальны. Вызывающий метод отвечает за обеспечение того, чтобы identifier был либо допустимым QUrl, либо QUrl по умолчанию.

sourceLocation идентифицирует местоположение в ресурсе (т. е. файле или документе), где было обнаружено сообщение, требующее отчёта.

Эта функция безусловно вызывает handleMessage(), передавая все её параметры без изменений.

См. также http://www.w3.org/TR/xquery/#errors.