PyQt Tips and Tricks

(wikify slightly)
(Stacked Windows)
Line 61: Line 61:
<source lang="python">
<source lang="python">
  class showWindowQtGui.QMainWindow):
  class showWindow(QtGui.QMainWindow):
     def __init__(self, parent=None):
     def __init__(self, parent=None):
         QtGui.QWidget.__init__(self, parent)
         QtGui.QWidget.__init__(self, parent)

Revision as of 10:10, 18 July 2010

With Meego there is a lot of interest in developing applications in Qt rather than GTK. This page spawned from a discussion thread.


Tips and Tricks

Identifying the Sender of a Signal

There are two main approaches for this. The first is to wrap the slot with a lambda to pass in any additional arguments:

def notifyMe(foo)
  print foo
f = QPushButton("Click me!")
x = lambda: notifyMe("they call him tim")
self.connect(f, SIGNAL("clicked()"), x)


The second and more general solution is to use the QSignalMapper[2]

Learning to use Qt CSS

Much like web development, CSS is also available within Qt. There's a list of examples that can be tried out just using Qt Designer. If you're using custom CSS, using palette() in your CSS definitions will allow you to use colors that the theme already knows about. As an example, this is an easy way to get the default blue color on your buttons when you want that color.

Depending on your needs, there's a number of built-in icons that are available for use.[3]

Style sheets and the native QMaemo5Style do not mix very well, since Maemo 5 lays out and draws some widgets very differently (e.g. QRadioButton). We recommend using local style sheets on specific widgets only, instead of setting one via QApplication::setStyleSheet().[4]

QString and Python

I've had some Unicode-related issues when moving strings between Python datatypes and Qt datatypes. Somehow, the Unicode stuff would get lost. So, it's likely easiest (At least when you're new to Python and Qt) to use QString and QStringList than their pure Python counterparts.

If you're not bringing in data from anywhere else, this isn't that big of a deal, but if you're interacting with data from any other source, Unicode is a pretty likely scenario these days.[5]

Just to note that, in my experience, locales fail to work with PyQt - QTextCodec.codecForLocale() does not return the correct codec, which also means QString's toLocal8Bit() and fromLocal8Bit() fail.

The Python locale stuff works fine, but then you have the joy of converting between QString and Python strings (which works perfectly when it does it implicitly, but an explicit conversion seems to go via ASCII unless you specifically tell it to use UTF-8 instead). [6]

Qt and Threads

There are multiple options for preemptive threading and cooperative threading. The big question is QThread or threading.Thread. This has been discussed on the PyQt mailing list and SO


It is discouraged to inherit from QThread and to use moveToThread on the QThread.[7]. A C++ example of how to use these is shown in a producer/consumer style application can be found on the trolltech blog.

import threading

It appears QThread initializes some TLS for data essential for thread safe signals and slots. Also when creating cross-thread signals it queues the signal emission rather than doing it immediately. These present problems when wanting to use the native Python Threading in a Qt application.[8][9]

If the Python thread would not interact directly with Qt then using Python threads is fine without any consideration.

Sometimes you must use Python threads with Qt like when porting applications. One solution to this is to pump messages into a queue and have an QTimer poll the queue periodically for tasks to process in the UI thread.[10]


Spread the work across multiple callbacks to allow the UI to remain responsive. See multiple QTimer types. If you're not relying on third parties (anything that will block the interpreter - whether it be waiting on hardware or a call via XMLRPC) QTimers are probably a good choice.

As an example, I wrote an app that would play a series of .jpg images as a movie in a player. While using a thread would work, using a QTimer worked great as well, since there was no waiting for hardware.

Stacked Windows

 class showWindow(QtGui.QMainWindow):
    def __init__(self, parent=None):
        QtGui.QWidget.__init__(self, parent)
        self.ui = Ui_main_window()


Example Applications

This is an overview of some of the PyQt applications available for Maemo. For some of the apps, there's a brief outline of unique functions they might have that you might want for your app.

The official PyQt bindings come with Python-based examples for many things. There's also examples for PyQt on Maemo 5 with Python examples, as well.

If you want to learn to become better in Python and Qt, reading code is one of the better ways to do it.

Web Resources