This document describes a set of Python bindings for the Qt widget set.
Contact the author at <phil@riverbankcomputing.co.uk>.
PyQt is a set of Python bindings for the Qt toolkit and available for all platforms supported by Qt, including Windows, Linux, UNIX, MacOS/X and embedded systems such as the Sharp Zaurus and the Compaq iPAQ. They have been tested against Qt versions 1.43 to 3.3.7, Qt Non-commercial, Qtopia 1.5.0, and Python versions 1.5 to 2.5. Qt/Embedded v3 is not supported. Qt v4 is supported by PyQt v4.
PyQt is available under the GPL license for use with the GPL version of Qt, a a commercial license for use with the commercial version of Qt, a non-commercial license for use with the non-commercial version of Qt v2, and an educational license for use with the educational version of Qt.
PyQt is built using SIP (a tool for generating Python extension modules for C++ class libraries). SIP v4.6 or later must be installed in order to build and run this version of PyQt.
PyQt for MacOS/X requires Qt v3.1.0 or later and Python v2.3 or later.
The bindings are implemented as a number of Python modules
qt is the main module and contains the core classes and most user interface widgets.
qtaxcontainer contains a sub-set of the classes implemented in Qt's QAxContainer module, part of Qt's ActiveQt framework.
qtcanvas contains the classes implemented in Qt's Canvas module.
qtgl contains the classes implemented in Qt's OpenGL module.
qtnetwork contains the classes implemented in Qt's Network module.
qtpe contains the classes implemented in Qtopia (originally called the Qt Palmtop Environment). It is only supported with Qt/Embedded.
qtsql contains the classes implemented in Qt's SQL module.
qttable contains the classes implemented in Qt's Table module.
qtui contains the classes implemented in Qt's qui library. These allow GUIs to be created directly from Qt Designer's .ui files.
qtxml contains the classes implemented in Qt's XML module.
qtext contains useful third-party classes that are not part of Qt. At the moment it contains bindings for QScintilla, the port to Qt of the Scintilla programmer's editor class.
PyQt also includes the pyuic and pylupdate utilities which correspond to the Qt uic and lupdate utilities. pyuic converts the GUI designs created with Qt Designer to executable Python code. pylupdate scans Python code, extracts all strings that are candidates for internationalisation, and creates an XML file for use by Qt Linguist.
Qt Designer is a GPL'ed GUI design editor provided by Trolltech as part of Qt. It generates an XML description of a GUI design. Qt includes uic which generates C++ code from that XML.
PyQt includes pyuic which generates Python code from the same XML. The Python code is self contained and can be executed immediately.
It is sometimes useful to be able to include some specific Python code in the output generated by pyuic. For example, if you are using custom widgets, pyuic has no way of knowing the name of the Python module containing the widget and so cannot generate the required import statement. To help get around this, pyuic will extract any lines entered in the Comment field of Qt Designer's Form Settings dialog that begin with Python: and copies them to the generated output.
Here's a simple example showing the contents of the Comment field.
This comment will be ignored by pyuic. Python: Python:# Import our custom widget. Python:from foo import bar |
Here's the corresponding output from pyuic.
from qt import * # Import our custom widget. from foo import bar |
Thanks to Christian Bird, pyuic will extract Python code entered using Qt Designer to implement slots. In Qt Designer, when you need to edit a slot and the source editor appears, enter Python code between the curly braces. Don't worry about the correct starting indent level, each line is prepended with a correct indentation.
Make sure that the ui.h file is in the same directory as the .ui file when using pyuic. The .ui file implies the name of the .ui.h file so there is no need to specify it on the command line.
Here's an example of a simple slot.
void DebMainWindowFrm::browsePushButtonClicked()
{
if self.debugging:
QMessageBox.critical(self, "Event", "browse pushbutton was clicked!")
} |
Here is the resulting code when pyuic is run.
class DebMainWindowFrm(QMainWindow):
...stuff...
def browsePushButtonClicked(self):
if self.debugging:
QMessageBox.critical(self, "Event", "browse pushbutton was clicked!") |
Note that indenting is as normal and that self and all other parameters passed to the slot are available.
If you use this, you will need to turn off all of the fancy options for the C++ editor in Designer as it tries to force C++ syntax and that's naturally annoying when trying to code in Python.
Qt includes the lupdate program which parses C++ source files converting calls to the QT_TR_NOOP() and QT_TRANSLATE_NOOP() macros to .ts language source files. The lrelease program is then used to generate .qm binary language files that are distributed with your application.
Thanks to Detlev Offenbach, PyQt includes the pylupdate program. This generates the same .ts language source files from your PyQt source files.
When deploying commercial PyQt applications it is necessary to discourage users from accessing the underlying PyQt modules for themselves. A user that used the modules shipped with your application to develop new applications would themselves be considered a developer and would need their own commercial Qt and PyQt licenses.
One solution to this problem is the VendorID package. This allows you to build Python extension modules that can only be imported by a digitally signed custom interpreter. The package enables you to create such an interpreter with your application embedded within it. The result is an interpreter that can only run your application, and PyQt modules that can only be imported by that interpreter. You can use the package to similarly restrict access to any extension module.
In order to build PyQt with support for the VendorID package, pass the -i command line flag to configure.py.
The SIP build system (ie. the sipconfig module) is described in the SIP documentation. PyQt includes the pyqtconfig module that can be used by configuration scripts of other bindings that are built on top of PyQt.
The pyqtconfig module contains the following classes:
This class encapsulates additional configuration values, specific to PyQt, that can be accessed as instance variables.
The following configuration values are provided (in addition to those provided by the sipconfig.Configuration class):
The name of the directory containing the pyuic and pylupdate executables.
The name of the directory containing the PyQt modules.
A string containing the names of the PyQt modules that were installed.
A string of the SIP flags used to generate the code for the qt module and which should be added to those needed by any module that imports the qt module.
A string of the SIP flags used to generate the code for the qtaxcontainer module and which should be added to those needed by any module that imports the qtaxcontainer module.
A string of the SIP flags used to generate the code for the qtcanvas module and which should be added to those needed by any module that imports the qtcanvas module.
A string of the SIP flags used to generate the code for the qtext module and which should be added to those needed by any module that imports the qtext module.
A string of the SIP flags used to generate the code for the qtgl module and which should be added to those needed by any module that imports the qtgl module.
A string of the SIP flags used to generate the code for the qtnetwork module and which should be added to those needed by any module that imports the qtnetwork module.
A string of the SIP flags used to generate the code for the qtsql module and which should be added to those needed by any module that imports the qtsql module.
A string of the SIP flags used to generate the code for the qttable module and which should be added to those needed by any module that imports the qttable module.
A string of the SIP flags used to generate the code for the qtui module and which should be added to those needed by any module that imports the qtui module.
A string of the SIP flags used to generate the code for the qtxml module and which should be added to those needed by any module that imports the qtxml module.
The name of the base directory where the .sip files for each of the PyQt modules is installed. A sub-directory exists with the same name as the module.
The PyQt version as a 3 part hexadecimal number (eg. v3.10 is represented as 0x030a00).
The PyQt version as a string. For development snapshots it will start with snapshot-.
The Makefile class for modules that import the qt module.
This is a reimplementation of sipconfig.Makefile.finalise().
The Makefile class for modules that import the qtaxcontainer module.
This is a reimplementation of sipconfig.Makefile.finalise().
The Makefile class for modules that import the qtcanvas module.
This is a reimplementation of sipconfig.Makefile.finalise().
The Makefile class for modules that import the qtext module.
This is a reimplementation of sipconfig.Makefile.finalise().
The Makefile class for modules that import the qtgl module.
This is a reimplementation of sipconfig.Makefile.finalise().
The Makefile class for modules that import the qtnetwork module.
This is a reimplementation of sipconfig.Makefile.finalise().
The Makefile class for modules that import the qttable module.
This is a reimplementation of sipconfig.Makefile.finalise().
The Makefile class for modules that import the qtsql module.
This is a reimplementation of sipconfig.Makefile.finalise().
The Makefile class for modules that import the qtui module.
This is a reimplementation of sipconfig.Makefile.finalise().
The Makefile class for modules that import the qtxml module.
This is a reimplementation of sipconfig.Makefile.finalise().
Internally PyQt implements a lazy technique for attribute lookup where attributes are only placed in type and instance dictionaries when they are first referenced. This technique is needed to reduce the time taken to import large modules such as PyQt.
In most circumstances this technique is transparent to an application. The exception is when super is used with a PyQt class. The way that super is currently implemented means that the lazy lookup is bypassed resulting in AttributeError exceptions unless the attribute has been previously referenced.
Note that this restriction applies to any class wrapped by SIP and not just PyQt.
Unicode support was added to Qt in v2.0 and to Python in v1.6. In Qt, Unicode support is implemented using the QString class. It is important to understand that QStrings, Python string objects and Python Unicode objects are all different but conversions between them are automatic in many cases and easy to achieve manually when needed.
Whenever PyQt expects a QString as a function argument, a Python string object or a Python Unicode object can be provided instead, and PyQt will do the necessary conversion automatically.
You may also manually convert Python string and Unicode objects to QStrings by using the QString constructor as demonstrated in the following code fragment.
qs1 = QString('Converted Python string object')
qs2 = QString(u'Converted Python Unicode object') |
In order to convert a QString to a Python string object use the Python str() function. Applying str() to a null QString and an empty QString both result in an empty Python string object.
In order to convert a QString to a Python Unicode object use the Python unicode() function. Applying unicode() to a null QString and an empty QString both result in an empty Python Unicode object.
When an instance of a C++ class is not created from Python it is not possible to access the protected member functions, or emit the signals, of that instance. Attempts to do so will raise a Python exception. Also, any Python methods corresponding to the instance's virtual member functions will never be called.
Throughout the bindings, the None value can be specified wherever NULL is acceptable to the underlying C++ code.
Equally, NULL is converted to None whenever it is returned by the underlying C++ code.
PyQt represents void * values as objects of type sip.voidptr. Such values are often used to pass the addresses of external objects between different Python modules. To make this easier, a Python integer (or anything that Python can convert to an integer) can be used whenever a sip.voidptr is expected.
A sip.voidptr may be converted to a Python integer by using the int() builtin function.
A sip.voidptr may be converted to a Python string by using its asstring() method. The asstring() method takes an integer argument which is the length of the data in bytes.
PyQt implements the full set of Qt's thread classes. Python, of course, also has its own thread extension modules. If you are using SIP v4 (or later) and Python v2.3.5 (or later) then PyQt does not impose any additional restrictions. (Read the relevant part of the Qt documentation to understand the restrictions imposed by the Qt API.)
If you are using earlier versions of either SIP or Python then it is possible to use either of the APIs so long as you follow some simple rules.
If you use the Qt API then the very first import of one of the PyQt modules must be done from the main thread.
If you use the Python API then all calls to PyQt (including any imports) must be done from one thread only. Therefore, if you want to make calls to PyQt from several threads then you must use the Qt API.
If you want to use both APIs in the same application then all calls to PyQt must be done from threads created using the Qt API.
The above comments actually apply to any SIP generated module, not just PyQt.
C++ does not garbage collect unreferenced class instances, whereas Python does. In the following C++ fragment both colours exist even though the first can no longer be referenced from within the program:
c = new QColor(); c = new QColor(); |
In the corresponding Python fragment, the first colour is destroyed when the second is assigned to c:
c = QColor() c = QColor() |
In Python, each colour must be assigned to different names. Typically this is done within class definitions, so the code fragment would be something like:
self.c1 = QColor() self.c2 = QColor() |
Sometimes a Qt class instance will maintain a pointer to another instance and will eventually call the destructor of that second instance. The most common example is that a QObject (and any of its sub-classes) keeps pointers to its children and will automatically call their destructors. In these cases, the corresponding Python object will also keep a reference to the corresponding child objects.
So, in the following Python fragment, the first QLabel is not destroyed when the second is assigned to l because the parent QWidget still has a reference to it.
p = QWidget()
l = QLabel('First label',p)
l = QLabel('Second label',p) |
Access to C++ variables is supported. They are accessed as Python instance variables. For example:
tab = QTab() tab.label = "First Tab" tab.r = QRect(10,10,75,30) |
Global variables and static class variables are effectively read-only. They can be assigned to, but the underlying C++ variable will not be changed. This may change in the future.
Access to protected C++ class variables is not supported. This may change in the future.
It is not possible to define a new Python class that sub-classes from more than one Qt class.
Qt implements i18n support through the Qt Linguist application, the QTranslator class, and the QApplication::translate(), QObject::tr() and QObject::trUtf8() methods. Usually the tr() method is used to obtain the correct translation of a message. The translation process uses a message context to allow the same message to be translated differently. tr() is actually generated by moc and uses the hardcoded class name as the context. On the other hand, QApplication::translate() allows to context to be explicitly stated.
Unfortunately, because of the way Qt implents tr() (and trUtf8()) it is not possible for PyQt to exactly reproduce its behavour. The PyQt implementation of tr() (and trUtf8()) uses the class name of the instance as the context. The key difference, and the source of potential problems, is that the context is determined dynamically in PyQt, but is hardcoded in Qt. In other words, the context of a translation may change depending on an instance's class hierarchy.
class A(QObject):
def __init__(self):
QObject.__init__(self)
def hello(self):
return self.tr("Hello")
class B(A):
def __init__(self):
A.__init__(self)
a = A()
a.hello()
b = B()
b.hello() |
In the above the message is translated by a.hello() using a context of A, and by b.hello() using a context of B. In the equivalent C++ version the context would be A in both cases.
The PyQt behaviour is unsatisfactory and may be changed in the future. It is recommended that QApplication.translate() be used in preference to tr() (and trUtf8()). This is guaranteed to work with current and future versions of PyQt and makes it much easier to share message files between Python and C++ code. Below is the alternative implementation of A that uses QApplication.translate().
class A(QObject):
def __init__(self):
QObject.__init__(self)
def hello(self):
return qApp.translate("A","Hello") |
Note that the code generated by pyuic uses QApplication.translate().
A signal may be either a Qt signal (specified using SIGNAL()) or a Python signal (specified using PYSIGNAL()).
A slot can be either a Python callable object, a Qt signal (specified using SIGNAL()), a Python signal (specified using PYSIGNAL()), or a Qt slot (specified using SLOT()).
You connect signals to slots (and other signals) as you would from C++. For example:
QObject.connect(a,SIGNAL("QtSig()"),pyFunction)
QObject.connect(a,SIGNAL("QtSig()"),pyClass.pyMethod)
QObject.connect(a,SIGNAL("QtSig()"),PYSIGNAL("PySig"))
QObject.connect(a,SIGNAL("QtSig()"),SLOT("QtSlot()"))
QObject.connect(a,PYSIGNAL("PySig"),pyFunction)
QObject.connect(a,PYSIGNAL("PySig"),pyClass.pyMethod)
QObject.connect(a,PYSIGNAL("PySig"),SIGNAL("QtSig()"))
QObject.connect(a,PYSIGNAL("PySig"),SLOT("QtSlot()")) |
When a slot is a Python method that corresponds to a Qt slot then a signal can be connected to either the Python method or the Qt slot. The following connections achieve the same effect.
sbar = QScrollBar()
lcd = QLCDNumber()
QObject.connect(sbar,SIGNAL("valueChanged(int)"),lcd.display)
QObject.connect(sbar,SIGNAL("valueChanged(int)"),lcd,SLOT("display(int)")) |
The difference is that the second connection is made at the C++ level and is more efficient.
Disconnecting signals works in exactly the same way.
Any instance of a class that is derived from the QObject class can emit a signal using the emit method. This takes two arguments. The first is the Python or Qt signal, the second is a Python tuple which are the arguments to the signal. For example:
a.emit(SIGNAL("clicked()"),())
a.emit(PYSIGNAL("pySig"),("Hello","World")) |
Note that when a slot is a Python callable object its reference count is not increased. This means that a class instance can be deleted without having to explicitly disconnect any signals connected to its methods. However, it also means that using lambda expressions as slots will not work unless you keep a separate reference to the expression to prevent it from being immediately garbage collected.
Qt allows a signal to be connected to a slot that requires fewer arguments than the signal passes. The extra arguments are quietly discarded. Python slots can be used in the same way.
Static member functions are implemented as Python class functions. For example the C++ static member function QObject::connect() is called from Python as QObject.connect() or self.connect() if called from a sub-class of QObject.
Enumerated types are implemented as a set of simple variables corresponding to the separate enumerated values.
When using an enumerated value the name of the class (or a sub-class) in which the enumerated type was defined in must be included. For example:
Qt.SolidPattern QWidget.TabFocus QFrame.TabFocus |
The following sections should be used in conjunction with the normal class documentation - only the differences specific to the Python bindings are documented here.
In these sections, Not yet implemented implies that the feature can be easily implemented if needed. Not implemented implies that the feature will not be implemented, either because it cannot be or because it is not appropriate.
If a class is described as being fully implemented then all non-private member functions and all public class variables have been implemented.
If an operator has been implemented then it is stated explicitly.
Classes that are not mentioned have not yet been implemented.
All constant values defined by Qt have equivalent constants defined to Python.
This takes one parameter which is a list of argument strings. Arguments used by Qt are removed from the list.
This takes two parameters, the first of which is a list of argument strings. Arguments used by Qt are removed from the list.
This takes two parameters, the first of which is a list of argument strings. Arguments used by Qt are removed from the list. (Qt v2.2+)
This has been renamed to exec_loop in Python.
A Python string can be used whenever a QByteArray can be used. A QByteArray can be converted to a Python string using the Python str() function.
Not implemented.
Not yet implemented.
Not yet implemented.
Not yet implemented.
Not yet implemented.
Not implemented.
Not implemented.
The Python == and != operators are supported.
This takes no parameters and returns the h, s and v values as a tuple.
This takes no parameters and returns the r, g and b values as a tuple.
This takes no parameters and returns the h, s and v values as a tuple.
This takes no parameters and returns the r, g and b values as a tuple.
This takes the initial, parent and name parameters and returns a tuple containing the QRgb result and the ok value.
This takes no parameters and returns a tuple of the x and y values. (Qt v2)
This takes only the t parameter and returns a tuple of the hframe, vframe and overlap values. (Qt v2)
A Python string can be used whenever a QCString can be used. A QCString can be converted to a Python string using the Python str() function.
Not implemented.
This returns a tuple of the short result and the ok value.
This returns a tuple of the ushort result and the ok value.
This returns a tuple of the int result and the ok value.
This returns a tuple of the uint result and the ok value.
This returns a tuple of the long result and the ok value.
This returns a tuple of the ulong result and the ok value.
This returns a tuple of the float result and the ok value.
This returns a tuple of the double result and the ok value.
This takes no parameters. The QDataStream result and the data read are returned as a tuple.
This takes only the l parameter. The QDataStream result and the data read are returned as a tuple.
len is derived from s and not passed as a parameter.
len is derived from s and not passed as a parameter.
The Python ==, !=, <, <=, >, >= and __nonzero__ operators are supported.
This takes no parameters and returns the week number and the year number as a tuple. (Qt v3.1+)
QDateTime is fully implemented, including the Python ==, !=, <, <=, >, >= and __nonzero__ operators.
QTime is fully implemented, including the Python ==, !=, <, <=, >, >= and __nonzero__ operators.
This has been renamed to exec_loop in Python.
This method also causes ownership of the underlying C++ dialog to be transfered to Python. This means that the C++ dialog will be deleted when the Python wrapper is garbage collected. Although this is a little inconsistent, it ensures that the dialog is deleted without having to explicity code it using QObject.deleteLater() or other techniques.
QDir is fully implemented, including the Python len, [] (for reading slices and individual elements), ==, != and in operators
This class isn't implemented. Whenever a QFileInfoList is the return type of a function or the type of an argument, a Python list of QFileInfo instances is used instead.
This takes the w parameter and returns the index of the QDockWIndow or -1 if the QDockArea does not contain the QDockWindow.
QEvent is fully implemented.
Instances of QEvents are automatically converted to the correct sub-class.
QCustomEvent is fully implemented. Any Python object can be passed as the event data and its reference count is increased.
Not implemented.
This takes a single len parameter. The data is returned if there was no error, otherwise None is returned.
This takes a single maxlen parameter. The data is returned if there was no error, otherwise None is returned.
Not yet implemented. (Qt v2+)
Not yet implemented. (Qt v2+)
len is derived from data and not passed as a parameter.
QFilePreview is fully implemented. However it cannot be used from Python in the same way as it is used from C++ because PyQt does not support multiple inheritance involving more than one wrapped class. A trick that seems to work is to use composition rather than inheritance as in the following code fragment.
class FilePreview(QFilePreview):
pass
class Preview(QLabel):
def __init__(self, parent=None):
QLabel.__init__(self, parent)
self.preview = FilePreview()
self.preview.previewUrl = self.previewUrl |
Note that QFilePreview cannot be instantiated directly because it is abstract. Thanks to Hans-Peter Jansen for this trick.
This takes the def, parent and name parameters and returns a tuple containing the QFont result and the ok value.
This takes the parent and name parameters and returns a tuple containing the QFont result and the ok value.
QRect boundingRect(int x, int y, int w, int h, int flags, const QString &str, int len = -1, int tabstops = 0, int *tabarray = 0);The tabarray parameter is a Python list of integers.
The tabarray parameter is a Python list of integers.
The Python == and != operators are supported.
This takes a list of strings as its parameter.
The colorTable parameter is a list of QRgb instances or None. (Qt v2.1+)
The return value is a sip.voidptr object which is only useful if passed to another Python module.
The return value is a sip.voidptr object which is only useful if passed to another Python module.
Not implemented.
The return value is a sip.voidptr object which is only useful if passed to another Python module.
len is derived from buf and not passed as a parameter.
The return value is a sip.voidptr object which is only useful if passed to another Python module.
static void defineIOHandler(const char *format, const char *header, const char *flags, image_io_handler read_image, image_io_handler write_image);Not implemented.
static QString getText(const QString &caption, const QString &label, const QString &text = QString::null, bool *ok = 0, QWidget *parent = 0, const char *name = 0);The ok is not passed and the returned value is a tuple of the QString result and the ok flag. (Qt v2.1 - v2.3.1)
static QString getText(const QString &caption, const QString &label, QLineEdit::EchoModeecho, const QString &text = QString::null, bool *ok = 0, QWidget *parent = 0, const char *name = 0);The ok is not passed and the returned value is a tuple of the QString result and the ok flag. (Qt v2.2 - v2.3.1)
static QString getText(const QString &caption, const QString &label, QLineEdit::EchoModeecho = QLineEdit::Normal, const QString &text = QString::null, bool *ok = 0, QWidget *parent = 0, const char *name = 0);The ok is not passed and the returned value is a tuple of the QString result and the ok flag. (Qt v3+)
static int getInteger(const QString &caption, const QString &label, int num = 0, int from = -2147483647, int to = 2147483647, int step = 1, bool *ok = 0, QWidget *parent = 0, const char *name = 0);The ok is not passed and the returned value is a tuple of the int result and the ok flag.
static double getDouble(const QString &caption, const QString &label, double num = 0, double from = -2147483647, double to = 2147483647, int step = 1, bool *ok = 0, QWidget *parent = 0, const char *name = 0);The ok is not passed and the returned value is a tuple of the double result and the ok flag.
static QString getItem(const QString &caption, const QString &label, const QStringList &list, int current = 0, bool editable = TRUE, bool *ok = 0, QWidget *parent = 0, const char *name = 0);The ok is not passed and the returned value is a tuple of the QString result and the ok flag.
void scrollBarMetrics(const QTabBar *sb, int &sliderMin, int &sliderMax, int &sliderLength, int &buttonDim);This takes only the sb parameter and returns a tuple of the sliderMin, sliderMax, sliderLength and buttonDim values.
QKeySequence is fully implemented including the operators ==, !=, QString() and int(). A QString instance or a Python integer may be used whenever a QKeySequence can be used.
This takes the w parameter and returns a tuple containing the bool result, row and col. (Qt v2+)
This takes only the xpos parameter and returns the int result and the chr value as a tuple. (Qt v3+)
This has been renamed delChar in Python. (Qt v2+)
This takes no parameters and returns the bool result and the start and end values as a tuple. (Qt v3+)
Types based on the QList template are automatically converted to and from Python lists of the type.
This takes the index parameter and returns a tuple containing the bool result and yPos. (Qt v1.x)
QListView is fully implemented.
Note that to remove a child QListViewItem you must first call takeItem() and then del().
QListViewItem is fully implemented.
Note that to remove a child QListViewItem you must first call takeItem() and then del().
This returns a tuple of the short result and the ok value.
This returns a tuple of the ushort result and the ok value.
This returns a tuple of the int result and the ok value.
This returns a tuple of the uint result and the ok value.
This returns a tuple of the long result and the ok value.
This returns a tuple of the ulong result and the ok value.
This returns a tuple of the float result and the ok value.
This returns a tuple of the double result and the ok value.
This operator is fully implemented. (Qt v3+)
This operator is fully implemented. (Qt v3+)
This takes only the tb parameter and returns a tuple of the result, dock, index, nl and extraOffset values. (Qt v2.1.0+)
This returns a list of QToolBar instances. (Qt v2.1.0+)
Types based on the QMemArray template are automatically converted to and from Python lists of the type.
This takes no parameters and returns a tuple of the x and y values. (Qt v2)
void scrollBarMetrics(const QScrollBar *sb, int &sliderMin, int &sliderMax, int &sliderLength, int &buttonDim);This takes only the sb parameter and returns a tuple of the sliderMin, sliderMax, sliderLength and buttonDim values. (Qt v2)
void scrollBarMetrics(const QTabBar *sb, int &sliderMin, int &sliderMax, int &sliderLength, int &buttonDim);This takes only the sb parameter and returns a tuple of the sliderMin, sliderMax, sliderLength and buttonDim values. (Qt v2)
This takes only the t parameter and returns a tuple of the hframe, vframe and overlap values. (Qt v2)
This takes no parameters and returns a tuple of the line and col values. (Qt v1.x, Qt v2.x)
This has been renamed delChar in Python. (Qt v1.x, Qt v2.x)
This takes no parameters and returns a tuple of the line and col values. (Qt v1.x, Qt v2.x)
This takes no parameters and returns a tuple of the bool result and the line1, col1, line2 and col2 values.
Not yet implemented.
Not yet implemented.
static bool disconnect(const QObject *sender, const char *signal, const QObject *receiver, const char *member);At the moment PyQt does not support the full behaviour of the corresponding Qt method. In particular, specifying None (ie. 0 in C++) for the signal and receiver parameters is not yet supported.
This class isn't implemented. Whenever a QObjectList is the return type of a function or the type of an argument, a Python list of QObject instances is used instead.
QRect boundingRect(int x, int y, int w, int h, int flags, const char *str, int len = -1, char **intern = 0);The intern parameter is not supported.
The intern parameter is not supported.
void drawText(int x, int y, int w, int h, int flags, const char *str, int len = -1, QRect *br = 0, char **intern = 0);The intern parameter is not supported.
void drawText(const QRect&, int flags, const char *str, int len = -1, QRect *br = 0, char **intern = 0);The intern parameter is not supported.
This takes a single parameter which is a list of tab stops.
This returns a list of tab stops.
This takes a list of strings as its parameter.
len is derived from buf and not passed as a parameter.
Not implemented.
Types based on the QPair template are automatically converted to and from Python tuples of two elements.
void scrollBarMetrics(const QTabBar *sb, int &sliderMin, int &sliderMax, int &sliderLength, int &buttonDim);This takes only the sb parameter and returns a tuple of the sliderMin, sliderMax, sliderLength and buttonDim values. (Qt v2)
The Python +, +=, -, -=, unary -, *, *=, /, /=, ==, != and __nonzero__ operators are supported.
Not implemented.
Not implemented.
This takes a single parameter which is a list of points.
This takes the single parameter i and returns the x and y values as a tuple.
This takes two parameters, index and a list of points.
Not implemented.
This takes a single parameter which is a list of points.
Not implemented.
Types based on the QPtrList template are automatically converted to and from Python lists of the type.
The Python &, &=, |, |=, ==, !=, in and __nonzero__ operators are supported.
This takes no parameters and returns a tuple containing the four values.
This takes no parameters and returns a tuple containing the four values.
Not implemented. (Qt v2+)
Not implemented. (Qt v2+)
Not implemented. (Qt v2+)
Not implemented. (Qt v2+)
The Python == and != operators are supported.
This takes str and index parameters and returns a tuple of the int result and the len value. (Qt v1.x)
This takes str and index parameters and returns a tuple of the int result and the len value. (Qt v2+)
The Python |, |=, +, +=, &, &=, -, -=, ^, ^=, ==, !=, in and __nonzero__ operators are supported.
Not implemented.
Not yet implemented. (Qt v2.2+)
This takes the x and y parameters and returns a tuple containing the vx and vy values. (Qt v2+)
This takes the vx and vy parameters and returns a tuple containing the x and y values. (Qt v2+)
QSemaphore is fully implemented. The += and -= operators have also been implemented, but require Python v2.0 or later.
The ok is not passed and the returned value is a tuple of the bool result and the ok flag.
The ok is not passed and the returned value is a tuple of the double result and the ok flag.
The ok is not passed and the returned value is a tuple of the QString result and the ok flag.
The ok is not passed and the returned value is a tuple of the QStringList result and the ok flag.
The ok is not passed and the returned value is a tuple of the QStringList result and the ok flag.
The ok is not passed and the returned value is a tuple of the int result and the ok flag.
Not implemented.
void scrollBarMetrics(const QScrollBar *sb, int &sliderMin, int &sliderMax, int &sliderLength, int &buttonDim);This takes only the sb parameter and returns a tuple of the sliderMin, sliderMax, sliderLength and buttonDim values. (Qt v2)
The Python +, +=, -, -=, *, *=, /, /=, ==, != and __nonzero__ operators are supported.
Not implemented.
Not implemented.
A Python string object (or Unicode object) can be used whenever a QString can be used. A QString can be converted to a Python string object using the Python str() function, and to a Python Unicode object using the Python unicode() function.
The Python +=, len, [] (for reading slices and individual characters), in and comparison operators are supported.
Not yet implemented. (Qt v2+)
Not yet implemented. (Qt v2+)
Not yet implemented. (Qt v2+)
Not yet implemented. (Qt v2.1+)
Not implemented.
This returns a tuple of the short result and the ok value.
This returns a tuple of the ushort result and the ok value.
This returns a tuple of the int result and the ok value.
This returns a tuple of the uint result and the ok value.
This returns a tuple of the long result and the ok value.
This returns a tuple of the ulong result and the ok value.
This returns a tuple of the float result and the ok value.
This returns a tuple of the double result and the ok value.
The Python len, [] (for both reading and writing slices and individual elements), del (for deleting slices and individual elements), +, +=, *, *=, ==, != and in operators are supported.
This does not return a value.
This does not return a value.
This class isn't implemented. Whenever a QStrList is the return type of a function or the type of an argument, a Python list of strings is used instead.
This takes no parameters and returns a tuple of the x and y values. (Qt v2)
virtual void scrollBarMetrics(const QScrollBar *b, int &sliderMin, int &sliderMax, int &sliderLength, int &buttonDim);Thus takes only the b parameter and returns a tuple of the sliderMin, sliderMax, sliderLength and buttonDim values. (Qt v2)
This takes only the t parameter and returns a tuple of the hframe, vframe and overlap values. (Qt v2)
This takes the col parameter and returns a tuple containing the bool result and xPos.
This takes the row parameter and returns a tuple containing the bool result and yPos.
This takes only the pos parameter and returns a tuple of the value returned via the para pointer and the int result.
This has been renamed delChar in Python.
virtual bool find(const QString &expr, bool cs, bool wo, bool forward = TRUE, int *para = 0, int *index = 0);If the para and index parameters are omitted then the bool result is returned. If both are supplied (as integers) then a tuple of the bool result and the modified values of para and index is returned.
This takes no parameters and returns a tuple of the values returned via the para and index pointers.
This takes only the selNum parameter and returns a tuple of the paraFrom, indexFrom, paraTo and indexTo values.
Types based on the QValueList template are automatically converted to and from Python lists of the type.
Not implemented.
Not yet implemented. (Qt v3+)
Not yet implemented.
Not yet implemented.
Not yet implemented. (Qt v3+)
Not implemented.
Not implemented.
Not implemented.
Not implemented.
Not implemented.
Not implemented.
Not implemented.
Not implemented.
Not implemented.
Not implemented.
Not implemented.
Not implemented.
Not implemented.
Not yet implemented. (Qt v3+)
Not yet implemented.
Not yet implemented.
Not implemented.
Not implemented.
This has been renamed to lowerW in Python.
This has been renamed to raiseW in Python.
This class isn't implemented. Whenever a QWidgetList is the return type of a function or the type of an argument, a Python list of instances is used instead.
This takes no parameters and returns a tuple of the x and y values. (Qt v2)
void scrollBarMetrics(const QTabBar *sb, int &sliderMin, int &sliderMax, int &sliderLength, int &buttonDim);This takes only the sb parameter and returns a tuple of the sliderMin, sliderMax, sliderLength and buttonDim values. (Qt v2)
This takes only the t parameter and returns a tuple of the hframe, vframe and overlap values. (Qt v2)
The Python ==, != and *= operators are supported.
This takes no parameters and returns a tuple of the QWMatrix result and the invertible value.
This takes the x and y parameters and returns a tuple containing the tx and ty values.
This takes the x and y parameters and returns a tuple containing the tx and ty values. (Qt v1.x)
This takes the x and y parameters and returns a tuple containing the tx and ty values. (Qt v2+)
Not implemented.
Not implemented.
Not implemented.
Not implemented.
This is a utility method provided by PyQt to make it easier to use Mark Hammond's win32com module to manipulate objects created by the qtaxcontainer module.
The RegisterActiveObject() COM function is called to register the QAxBase instance as a weak object with the guid GUID. The revoke handle is returned.
This is a wrapper around the RevokeActiveObject() COM function and is called to revoke the object registered using registerWeakActiveObject(). rhandle is the revoke handle returned by registerWeakActiveObject().
QCanvas is fully implemented.
This class isn't implemented. Whenever a QCanvasItemList is the return type of a function or the type of an argument, a Python list of QCanvasItem instances is used instead.
The pixmaps argument is a Python list of QPixmap instances, and the hotspots argument is a Python list of QPoint instances. (Qt v2.2.0 - Qt v2.3.1)
The pixmaps argument is a Python list of QPixmap instances. (Qt v3+)
This takes no parameters and returns a tuple of the values returned by the line and index pointers.
This takes no parameters and returns a tuple of the values returned by the lineFrom, indexFrom, lineTo and indexTo pointers.
QDns is fully implemented.
This takes a single maxlen parameter. The data is returned if there was no error, otherwise None is returned.
Not yet implemented.
Not yet implemented.
Not yet implemented.
Not yet implemented.
This takes a single maxlen parameter. The data is returned if there was no error, otherwise None is returned.
This takes a single len parameter. The data is returned if there was no error, otherwise Py_None is returned.
This takes a single maxlen parameter. The data is returned if there was no error, otherwise Py_None is returned.
len is derived from data and not passed as a parameter.
This takes a single len parameter. The data is returned if there was no error, otherwise None is returned.
len is derived from data and not passed as a parameter.
This takes two parameters, the first of which is a list of argument strings. Arguments used by Qt are removed from the list.
This has been renamed to exec_loop in Python.
This has been renamed delRecords in Python.
This has been renamed delRecords in Python.
This has been renamed execQuery in Python.
QSqlPropertyMap is fully implemented. However, because PyQt does not allow new properties to be defined, it is not possible to implement custom editor widgets in Python and add them to a property map. This will simple be ignored.
This problem may be addressed in a future release of PyQt.
Not yet implemented. (Qt v3.2.0+)
This has been renamed execQuery in Python.
This has been renamed execQuery in Python. (Qt v3.1+)
This has been renamed delRecords in Python.
This has been renamed execQuery in Python.
QDomImplementation is fully implemented.
bool setContent(const QCString &buffer, bool namespaceProcessing, QString *errorMsg = 0, int *errorLine = 0, int *errorColumn = 0);This takes the buffer and namespaceProcessing parameters and returns a tuple containing the bool result and the errorMsg, errorLine and errorColumn values. (Qt v3+)
bool setContent(const QByteArray &buffer, bool namespaceProcessing, QString *errorMsg = 0, int *errorLine = 0, int *errorColumn = 0);This takes the buffer and namespaceProcessing parameters and returns a tuple containing the bool result and the errorMsg, errorLine and errorColumn values. (Qt v3+)
bool setContent(const QString &text, bool namespaceProcessing, QString *errorMsg = 0, int *errorLine = 0, int *errorColumn = 0);This takes the text and namespaceProcessing parameters and returns a tuple containing the bool result and the errorMsg, errorLine and errorColumn values. (Qt v3+)
bool setContent(const QIODevice *dev, bool namespaceProcessing, QString *errorMsg = 0, int *errorLine = 0, int *errorColumn = 0);This takes the dev and namespaceProcessing parameters and returns a tuple containing the bool result and the errorMsg, errorLine and errorColumn values. (Qt v3+)
bool setContent(const QCString &buffer, QString *errorMsg = 0, int *errorLine = 0, int *errorColumn = 0);This takes the buffer parameter only and returns a tuple containing the bool result and the errorMsg, errorLine and errorColumn values. (Qt v3+)
bool setContent(const QByteArray &buffer, QString *errorMsg = 0, int *errorLine = 0, int *errorColumn = 0);This takes the buffer parameter only and returns a tuple containing the bool result and the errorMsg, errorLine and errorColumn values. (Qt v3+)
bool setContent(const QString &text, QString *errorMsg = 0, int *errorLine = 0, int *errorColumn = 0);This takes the text parameter only and returns a tuple containing the bool result and the errorMsg, errorLine and errorColumn values. (Qt v3+)
bool setContent(const QIODevice *dev, QString *errorMsg = 0, int *errorLine = 0, int *errorColumn = 0);This takes the dev parameter only and returns a tuple containing the bool result and the errorMsg, errorLine and errorColumn values. (Qt v3+)
bool setContent(QXmlInputSource *source, QXmlReader *reader, QString *errorMsg = 0, int *errorLine = 0, int *errorColumn = 0);Not yet implemented. (Qt v3.2.0+)