Boost Thread Qt Application

From Qt Wiki
Revision as of 10:03, 25 February 2015 by Maintenance script (talk | contribs)
Jump to: navigation, search

How-to launch Qt Application in a non-main thread

In this article I'll show how to manage running QApplication in a non-main thread. My need is to create an external shared library, that can offer a GUI interface when requested.

Anyway, I don't have control on the external process that loads my library, and I have to face the following two requirements:

a) loading of my library is performed in a thread; b) calling of the public method that shows GUI interfaces happens in a different thread.

My solution requires the usage of boost::thread class (even if you can use any other thread-management technology, i.e. POSIX thread API, but not QThread class). Boost Thread lets me preserve "code once, run everywhere" requirement.

Some basic ideas were taken from VLC source code.

Here's just a sample of my solution, that has been extracted from my top-secret code :)

application.hpp file:

  1. include <boost/thread/thread.hpp>
  1. include <QObject>
  2. include <QApplication>
  3. include <QEvent>
  4. include <QWaitCondition>
  5. include <QMutex>

class Application; class DialogProvider : public QObject {


Application *_qtApp;

QWaitCondition _waitCondition;

QMutex _mutex;
volatile bool _eventProcessed;

void signalEventProcessed()

QMutexLocker locker(&_mutex);
_eventProcessed = true;


Application *qtApp() const { return _qtApp; }

void customEvent(QEvent *event);


explicit DialogProvider(Application *qtApp, QObject parent = 0) :
_eventProcessed(false) { }
void waitForEventProcessed()
QMutexLocker locker(&_mutex);
if (!_eventProcessed)
_eventProcessed = false;


class ShowMyWidgetEvent : public QEvent {

int _paramA;
float _paramB;


explicit ShowWaitDialogEvent(QEvent::Type eventType,
int paramA, float paramB) :
_paramB(paramB) { }
int paramA() const { return _paramA; }
float paramB() const { return _paramB; }


class Application : public QApplication {


static int staticArgc;

static char staticDummy[];
static char *staticArgv[2];

QEvent::Type _showMyWidgetEventType;


virtual DialogProvider *createDialogProvider(Application *app)
{ return new DialogProvider(app,this); }


explicit Application();

DialogProvider *dpInstance();

QEvent::Type showMyWidgetEventType() const { return _showMyWidgetEventType; }

QEvent createShowMyWidgetEvent(int paramA, float paramB) const

{ return new ShowMyWidgetEvent(showMyWidgetEventType(),paramA,paramB); }


class ThreadedApplication {

volatile bool _started;
boost::mutex _dialogMutex;
boost::mutex _waitForApplicationRunningMutex;
boost::condition_variable _applicationRunningCondition;


Application *qtApp() const { return _app; }

virtual Application *createApplication() { return new Application(); }

boost::mutex &dialogMutex() { return _dialogMutex; }


explicit ThreadedApplication() :
_started(false) { }

virtual ~ThreadedApplication() { stop(); }

void operator()();

if (!_app)
boost::unique_lock< boost::mutex > guard(_waitForApplicationRunningMutex);

_app = createApplication();

_started = true;



void waitForApplicationRun()

boost::unique_lock< boost::mutex > guard(_waitForApplicationRunningMutex);
if (!_started)

void stop()

if (_app)

void showMyWidget(int paramA, float paramB)

if (_app)


  1. endif

application.cpp file:

  1. include <boost/thread/locks.hpp>
  1. include "application.hpp"

int Application::staticArgc = 1; char Application::staticDummy[] = "QtLibApplication"; char *Application::staticArgv[2] = { staticDummy, nullptr };

void DialogProvider::customEvent(QEvent *event) {

if (!_qtApp)
if (event->type() == _qtApp->showMyWidgetEventType())
ShowMyWidgetEvent ev = static_cast< ShowMyWidgetEvent >(event);
MyWidget *myWidget = new MyWidget(event->paramA(),event->paramB());




Application::Application() :

_showMyWidgetEventType(static_cast< QEvent::Type >(QEvent::registerEventType()))




DialogProvider *Application::dpInstance() {

if (!_dpInstance)
_dpInstance = createDialogProvider(this);

return _dpInstance; }

My goal is to create my widget in the same thread of QApplication, as Qt requires, wait until the widget is shown, and let my widget run in the QApplication event loop context.

When one of my shared library public methods is called for the first time, I create an instance of the runnable ThreadedApplication class, and I fire it using boost::thread:

ThreadedApplication *app = new ThreadedApplication(); boost::thread appThread(boost::ref(*app)); app->waitForApplicationRun();

So, let's call "Thread A" the thread that executes the public method of my library, that performs the three lines above. A new thread is created (the "boost" one), called "Thread B", that creates an instance of QApplication, my DialogProvider, and executes event loop of QApplication, everything in the same context. "Thread A" is blocked until I'm sure that my application is started, then returns.

Some time later, a new thread, called "Thread C", wants to call a different public method that shows my widget. I just need to call


Of course, the two parameters are specified as example. "Thread C" posts a custom event (that carries on all information I need to create my widget) to QApplication event loop, that forwards it to my DialogProvider customEvent method. In that method (I'm in QApplication context, i.e. "Thread B"), I can create my widget and show it[[Image:|Image:]] In the end, I just signal (using a QWaitCondition) that my widget is shown, so "Thread C" can return.

The final result is that all my Qt classes have been created in the QApplication thread context, just as a normal Qt application. Qt world is unaware of what has happened, and it never complains about anything.

Just a warning about widgets creation and destruction in customEvent method. NEVER delete them there[[Image:|Image:]]! QDialog based widgets can let you do wrong, cause usually you destroy the dialog just after executing them. Please use WA_DeleteOnClose attribute, as in my example, or defer their deletion using deleteLater method.

Comments on how to improve such solution are welcome[[Image:|Image:]]!