Table of Content

A Browser for QDebug Log Output

The code on this page shows how a simple log browser can be added to an application.

It consists of the actual log browser (class LogBrowserDialog in logbrowserdialog.h and logbrowserdialog.h) and a small wrapper (class LogBrowser in logbrowser.h and logbrowser.h). The wrapper is instantiated in the main function of an application and creates the browser window. It also acts as an intermediary and converts the const char * based messages from the debug system into QString based messages. With this trick the debug messages can be sent to the actual browser by the means of signal/slot connections. This adds basic thread support to the browser.

logbrowser.pro

  1. QT       += core gui
  2.  
  3. TARGET = DebugWindow
  4. TEMPLATE = app
  5.  
  6. SOURCES += main.cpp logbrowserdialog.cpp logbrowser.cpp
  7. HEADERS  += logbrowserdialog.h logbrowser.h

logbrowser.h

  1. #ifndef LOGBROWSER_H
  2. #define LOGBROWSER_H
  3.  
  4. #include <QObject>
  5.  
  6. class LogBrowserDialog;
  7.  
  8. class LogBrowser : public QObject
  9. {
  10.     Q_OBJECT
  11. public:
  12.     explicit LogBrowser(QObject *parent = 0);
  13.     ~LogBrowser();
  14.  
  15. public slots:
  16.     void outputMessage( QtMsgType type, const QString &msg );
  17.  
  18. signals:
  19.     void sendMessage( QtMsgType type, const QString &msg );
  20.  
  21. private:
  22.     LogBrowserDialog *browserDialog;
  23.  
  24. };
  25.  
  26. #endif // LOGBROWSER_H

logbrowser.cpp

  1. #include "logbrowser.h"
  2.  
  3. #include <QMetaType>
  4.  
  5. #include "logbrowserdialog.h"
  6.  
  7. LogBrowser::LogBrowser(QObject *parent) :
  8.     QObject(parent)
  9. {
  10.     qRegisterMetaType<QtMsgType>("QtMsgType");
  11.     browserDialog = new LogBrowserDialog;
  12.     connect(this, SIGNAL(sendMessage(QtMsgType,QString)), browserDialog, SLOT(outputMessage(QtMsgType,QString)), Qt::QueuedConnection);
  13.     browserDialog->show();
  14. }
  15.  
  16.  
  17. LogBrowser::~LogBrowser()
  18. {
  19.     delete browserDialog;
  20. }
  21.  
  22.  
  23. void LogBrowser::outputMessage(QtMsgType type, const QString &msg)
  24. {
  25.     emit sendMessage( type, msg );
  26. }

logbrowserdialog.h

  1. #ifndef DIALOG_H
  2. #define DIALOG_H
  3.  
  4. #include <QDialog>
  5.  
  6. class QTextBrowser;
  7. class QPushButton;
  8.  
  9. class LogBrowserDialog : public QDialog
  10. {
  11.     Q_OBJECT
  12.  
  13. public:
  14.     LogBrowserDialog(QWidget *parent = 0);
  15.     ~LogBrowserDialog();
  16.  
  17. public slots:
  18.     void outputMessage( QtMsgType type, const QString &msg );
  19.  
  20. protected slots:
  21.     void save();
  22.  
  23. protected:
  24.     virtual void keyPressEvent( QKeyEvent *e );
  25.     virtual void closeEvent( QCloseEvent *e );
  26.  
  27.     QTextBrowser *browser;
  28.     QPushButton *clearButton;
  29.     QPushButton *saveButton;
  30. };
  31.  
  32. #endif // DIALOG_H

logbrowserdialog.cpp

  1. #include "logbrowserdialog.h"
  2.  
  3. #include <QVBoxLayout>
  4. #include <QHBoxLayout>
  5. #include <QTextBrowser>
  6. #include <QPushButton>
  7. #include <QFileDialog>
  8. #include <QDir>
  9. #include <QFile>
  10. #include <QMessageBox>
  11. #include <QTextStream>
  12. #include <QCloseEvent>
  13. #include <QKeyEvent>
  14.  
  15. LogBrowserDialog::LogBrowserDialog(QWidget *parent)
  16.     : QDialog(parent)
  17. {
  18.     QVBoxLayout *layout = new QVBoxLayout;
  19.     setLayout(layout);
  20.  
  21.     browser = new QTextBrowser(this);
  22.     layout->addWidget(browser);
  23.  
  24.     QHBoxLayout *buttonLayout = new QHBoxLayout;
  25.     buttonLayout->setContentsMargins(0, 0, 0, 0);
  26.     layout->addLayout(buttonLayout);
  27.  
  28.     buttonLayout->addStretch(10);
  29.  
  30.     clearButton = new QPushButton(this);
  31.     clearButton->setText("clear");
  32.     buttonLayout->addWidget(clearButton);
  33.     connect(clearButton, SIGNAL(clicked()), browser, SLOT(clear()));
  34.  
  35.     saveButton = new QPushButton(this);
  36.     saveButton->setText("save output");
  37.     buttonLayout->addWidget(saveButton);
  38.     connect(saveButton, SIGNAL(clicked()), this, SLOT(save()));
  39.  
  40.     resize(200, 400);
  41. }
  42.  
  43.  
  44. LogBrowserDialog::~LogBrowserDialog()
  45. {
  46.  
  47. }
  48.  
  49.  
  50. void LogBrowserDialog::outputMessage(QtMsgType type, const QString &msg)
  51. {
  52.     switch (type) {
  53.     case QtDebugMsg:
  54.         browser->append(msg);
  55.         break;
  56.  
  57.     case QtWarningMsg:
  58.         browser->append(tr("-- WARNING: %1").arg(msg));
  59.         break;
  60.  
  61.     case QtCriticalMsg:
  62.         browser->append(tr("-- CRITICAL: %1").arg(msg));
  63.         break;
  64.  
  65.     case QtFatalMsg:
  66.         browser->append(tr("-- FATAL: %1").arg(msg));
  67.         break;
  68.     }
  69. }
  70.  
  71.  
  72. void LogBrowserDialog::save()
  73. {
  74.     QString saveFileName = QFileDialog::getSaveFileName(
  75.                 this,
  76.                 tr("Save Log Output"),
  77.                 tr("%1/logfile.txt").arg(QDir::homePath()),
  78.                 tr("Text Files (*.txt);;All Files (*)")
  79.                 );
  80.  
  81.     if(saveFileName.isEmpty())
  82.         return;
  83.  
  84.     QFile file(saveFileName);
  85.     if(!file.open(QIODevice::WriteOnly)) {
  86.         QMessageBox::warning(
  87.                     this,
  88.                     tr("Error"),
  89.                     QString(tr("<nobr>File '%1'<br/>cannot be opened for writing.<br/><br/>"
  90.                                "The log output could <b>not</b> be saved!</nobr>"))
  91.                     .arg(saveFileName));
  92.         return;
  93.     }
  94.  
  95.     QTextStream stream(&file);
  96.     stream << browser->toPlainText();
  97.     file.close();
  98. }
  99.  
  100.  
  101. void LogBrowserDialog::closeEvent(QCloseEvent *e)
  102. {
  103.     QMessageBox::StandardButton answer = QMessageBox::question(
  104.                 this,
  105.                 tr("Close Log Browser?"),
  106.                 tr("Do you really want to close the log browser?"),
  107.                 QMessageBox::Yes | QMessageBox::No
  108.                 );
  109.  
  110.     if (answer == QMessageBox::Yes)
  111.         e->accept();
  112.     else
  113.         e->ignore();
  114. }
  115.  
  116.  
  117. void LogBrowserDialog::keyPressEvent(QKeyEvent *e)
  118. {
  119.     // ignore all keyboard events
  120.     // protects against accidentally closing of the dialog
  121.     // without asking the user
  122.     e->ignore();
  123. }

main.cpp

  1. #include <QApplication>
  2. #include <QPointer>
  3. #include <QDebug>
  4. #include "logbrowser.h"
  5.  
  6. QPointer<LogBrowser> logBrowser;
  7.  
  8. void myMessageOutput(QtMsgType type, const char *msg)
  9. {
  10.     if(logBrowser)
  11.         logBrowser->outputMessage( type, msg );
  12. }
  13.  
  14.  
  15. int main(int argc, char *argv[])
  16. {
  17.     QApplication a(argc, argv);
  18.  
  19.     logBrowser = new LogBrowser;
  20.     qInstallMsgHandler(myMessageOutput);
  21.  
  22.     qDebug() << "test for debug";
  23.     int result = a.exec();
  24.     qDebug() << "application exec return result =" << result;
  25.  
  26.     delete logBrowser;
  27.     return result;
  28. }

Categories:

Creative Commons Attribution-ShareAlike 2.5 Generic

Content is available under

Creative Commons Attribution-ShareAlike 2.5 Generic

 

© 2011 Qt Project Hosting. Qt® and the Qt logo is a registered trade mark of Nokia Corporation and/or its subsidiaries and is used pursuant to a license from Nokia Corporation and/or its subsidiaries.
All other trademarks are property of their respective owners. Privacy Policy
This site is hosted by Gitorious AS. Your use of this web site is governed by these terms of service.

Qt Project Hosting, P.O. Box 4332 Nydalen, 0402 Oslo, Norway. Phone: +47 21 60 27 32. Org. Nr. 997 447 913