qgsmessagelog.h

Go to the documentation of this file.

/***************************************************************************
    qgsmessagelog.h  -  interface for logging messages
    ----------------------
    begin                : October 2011
    copyright            : (C) 2011 by Juergen E. Fischer
    email                : jef at norbit dot de
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef QGSMESSAGELOG_H
#define QGSMESSAGELOG_H
 
#include <QString>
#include <QObject>
 
#include "qgis_core.h"
#include "qgis.h"
 
class CORE_EXPORT QgsMessageLog : public QObject
{
    Q_OBJECT
 
  public:
 
    QgsMessageLog() = default;
 
    static void logMessage( const QString &message, const QString &tag = QString(), Qgis::MessageLevel level = Qgis::MessageLevel::Warning, bool notifyUser = true );
 
  signals:
 
    void messageReceived( const QString &message, const QString &tag, Qgis::MessageLevel level );
 
    //TODO QGIS 4.0 - remove received argument
 
    void messageReceived( bool received );
 
  private:
 
    void emitMessage( const QString &message, const QString &tag, Qgis::MessageLevel level, bool notifyUser = true );
 
    int mAdviseBlockCount = 0;
 
    friend class QgsMessageLogNotifyBlocker;
 
};
 
class CORE_EXPORT QgsMessageLogNotifyBlocker
{
  public:
 
    QgsMessageLogNotifyBlocker();
 
    QgsMessageLogNotifyBlocker( const QgsMessageLogNotifyBlocker &other ) = delete;
 
    QgsMessageLogNotifyBlocker &operator=( const QgsMessageLogNotifyBlocker &other ) = delete;
 
    ~QgsMessageLogNotifyBlocker();
 
  private:
 
#ifdef SIP_RUN
    QgsMessageLogNotifyBlocker( const QgsMessageLogNotifyBlocker &other );
#endif
};
 
class CORE_EXPORT QgsMessageLogConsole : public QObject
{
    Q_OBJECT
 
  public:
 
    QgsMessageLogConsole();
 
  protected:
 
    QString formatLogMessage( const QString &message, const QString &tag, Qgis::MessageLevel level = Qgis::MessageLevel::Info ) const;
 
  public slots:
 
    virtual void logMessage( const QString &message, const QString &tag, Qgis::MessageLevel level );
};
 
#endif