# Python Bindings for Qt (3.13)

### Phil Thompson

This document describes a set of Python bindings for the Qt widget set. Contact the author at `<phil@riverbankcomputing.co.uk>`.

## Introduction

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.3, Qt Non-commercial, Qtopia 1.5.0, and Python versions 1.5 to 2.4a3. Qt/Embedded v3 is not supported.

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.

There is also an evaluation version of PyQt for Windows. This must be used with the corresponding evaluation version of Qt.

PyQt is built using SIP (a tool for generating Python extension modules for C++ class libraries). SIP v3.10.2 or later must be installed in order to build and run this version of PyQt.

PyQt for MacOS/X requires SIP v4.0 or later, 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. (Note that SIP v4.2 or later is required.)

- `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.

### Changes

The changes visible to the Python programmer in this release are as follows.

- Added support for all the `<<` and `>>` operators between `QDataStream` and wrapped classes.

- Added support for the comparison operators between `QChar` and `QChar` and `char`.

- Added support for the `QMetaObject`, `QMetaProperty` and `QUuid` classes.

- Added support for the `QObject.metaObject()` method.

- Added support for QScintilla v1.4 including the `QextScintillaLexerBash` class.

## Other PyQt Goodies

### Using Qt Designer

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.

### Using Qt Linguist

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.

## Application Deployment

Note that these notes assume the use of SIP v4.x.

Deploying Python applications can be problematical because of the relatively complex nature of a Python installation. Ideally the deployed application would be completely self-contained and not conflict with anything already installed on the target system.

Another issue for commercial PyQt applications is the desire to physically prevent users accessing the underlying PyQt modules for themselves. Doing so means they become developers and need their own commercial Qt and PyQt licenses.

This section is a set of suggestions and not a formal prescription of how PyQt applications should be deployed. We would appreciate any feedback and suggestions for improvement.

### Hiding the PyQt Modules (UNIX/Linux)

In this section we describe how to build a version of the Python interpreter with the SIP and PyQt modules built in rather than dynamically loaded. The advantage of doing this is that, when combined with the techniques described below for producing self-contained executables, it is difficult for the end user to gain access to the underlying modules to use in their own applications.

None of the steps below require any special user privileges, and do not affect any existing Python, Qt or PyQt installation.

Note that a further improvement would be achieved by using a static version of the Qt library.

#### Bootstrap Python

Unpack the Python source code.

Build Python as normal, but specify an installation prefix. For example:

    ./configure --prefix=/path/to/deploy
    make
    make install

#### Build SIP

Unpack the SIP source code.

Run `configure.py` with the `-k` flag (plus whatever flags you would normally use) using the Python interpreter you have just created.

    /path/to/deploy/bin/python configure.py -k

Build the static version of SIP by running:

    make
    make install

#### Build PyQt

Unpack the PyQt source code.

Run `configure.py` with the `-k` flag (plus whatever flags you would normally use) using the Python interpreter you have just created.

    /path/to/deploy/bin/python configure.py -k

Build the static version of PyQt by running:

    make

#### Rebuilding Python

Return to the Python source directory.

Edit `Makefile.pre.in` and add the macros `PYQT_OBJS` and `PYQT_LIBS`.

`PYQT_OBJS` contains the path names of all the object files that were created when you built the static SIP and PyQt modules, ie. the outputs of `ls siplib/*.o` and `ls qt*/*.o` from the SIP and PyQt source directories respectively.

`PYQT_LIBS` contains the command line flags needed to link the various Qt libraries. For example:

    PYQT_LIBS= -L/usr/local/qt/lib -lqscintilla -lqassistantclient -lqui -lqt-mt

Add `$(PYQT_OBJS)` to the definition of `LIBRARY_OBJS`.

Add `$(AR) cr $@ $(PYQT_OBJS)` to the commands of the `$(LIBRARY)` target.

Add `$(PYQT_LIBS)` before `$(SYSLIBS)` in the `$(BUILDPYTHON)` target.

Edit `Modules/config.c.in` and add the following after `ADDMODULE MARKER 1`:

            extern void initsip(void);
            extern void initqt(void);
            extern void initqtcanvasc(void);
            extern void initqtextc(void);
            extern void initqtglc(void);
            extern void initqtnetworkc(void);
            extern void initqtsqlc(void);
            extern void initqttablec(void);
            extern void initqtuic(void);
            extern void initqtxmlc(void);

Add the following after `ADDMODULE MARKER 2`:

            {"sip", initsip},
            {"qt", initqt},
            {"qtcanvas", initqtcanvas},
            {"qtext", initqtext},
            {"qtgl", initqtgl},
            {"qtnetwork", initqtnetwork},
            {"qtsql", initqtsql},
            {"qttable", initqttable},
            {"qtui", initqtui},
            {"qtxml", initqtxml},

Reconfigure, build and install Python again using the same flags as before.

### Hiding the PyQt Modules (Windows)

The same basic approach used on UNIX/Linux should work on Windows except that it is probably easier to use a normal Python installation and only produce a modified Python DLL. MSVC++ also seems to have some issues compiling a static version of the SIP module against a DLL version of the Qt library, so you should also use a static version of the Qt library.

### Producing Self-contained Executables

This section outlines how to produce self-contained executables based on Gordon McMillan's Installer package (http://www.mcmillan-inc.com/installer_dnld.html).

The use of `upx` (http://upx.sourceforge.net) for generating compressed executables is recommended. Limited testing has shown that it can reduce the size of your final application by as much as a half.

#### Installing Installer

Unpack the Installer package. On Windows, no further steps are required. On UNIX/Linux, the following configuration steps are required.

Edit `source/linux/Make.py` and insert `'$(PYQT_LIBS)'` before `'$(SYSLIBS)'`.

Run the following:

    cd source/linux
    /path/to/deploy/bin/python Make.py
    make
    cd ../..
    /path/to/deploy/bin/python Configure.py

#### An Example

Using Installer involves two simple steps: generating a specification then generating the application executable itself.

On UNIX/Linux:

    /path/to/deploy/bin/python Makespec.py --onefile --upx --strip /path/to/tut14.py
    /path/to/deploy/bin/python Build.py tut14/tut14.spec

On Windows:

    \path\to\python Makespec.py --onefile --upx \path\to\tut14.py
    \path\to\python Build.py tut14\tut14.spec

The executable can be found in the `tut14` sub-directory. On a Linux system the executable is about 6.5Mbytes. On a Windows system the executable is about 2.5Mbytes.

#### Caveats

Applications with external data (eg. external images, translation files) probably need some additional steps.

When the `--onefile` option is used with Installer, a temporary directory is created when the application is run that contains the shared libraries needed by the application. If the application terminates normally then this directory is removed automatically. However there appears to be a bug (or maybe it's a feature) in the current version of Installer (v5b5) where the directory is not removed if the application is terminated through `sys.exit()`.

## `pyqtconfig` and Build System Support

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:

`Configuration(sipconfig.Configuration)`

  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):

  `pyqt_bin_dir`

    The name of the directory containing the `pyuic` and `pylupdate` executables.

  `pyqt_mod_dir`

    The name of the directory containing the PyQt modules.

  `pyqt_modules`

    A string containing the names of the PyQt modules that were installed.

  `pyqt_qt_sip_flags`

    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.

  `pyqt_qtaxcontainer_sip_flags`

    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.

  `pyqt_qtcanvas_sip_flags`

    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.

  `pyqt_qtext_sip_flags`

    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.

  `pyqt_qtgl_sip_flags`

    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.

  `pyqt_qtnetwork_sip_flags`

    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.

  `pyqt_qtsql_sip_flags`

    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.

  `pyqt_qttable_sip_flags`

    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.

  `pyqt_qtui_sip_flags`

    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.

  `pyqt_qtxml_sip_flags`

    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.

  `pyqt_sip_dir`

    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.

  `pyqt_version`

    The PyQt version as a 3 part hexadecimal number (eg. v3.10 is represented as `0x030a00`).

  `pyqt_version_str`

    The PyQt version as a string. For development snapshots it will start with `snapshot-`.

`QtModuleMakefile(sipconfig.SIPModuleMakefile)`

  The Makefile class for modules that import the `qt` module.

  `finalise(self)`

    This is a reimplementation of `sipconfig.Makefile.finalise()`.

`QtAxContainerModuleMakefile(QtModuleMakefile)`

  The Makefile class for modules that import the `qtaxcontainer` module.

  `finalise(self)`

    This is a reimplementation of `sipconfig.Makefile.finalise()`.

`QtCanvasModuleMakefile(QtModuleMakefile)`

  The Makefile class for modules that import the `qtcanvas` module.

  `finalise(self)`

    This is a reimplementation of `sipconfig.Makefile.finalise()`.

`QtExtModuleMakefile(QtModuleMakefile)`

  The Makefile class for modules that import the `qtext` module.

  `finalise(self)`

    This is a reimplementation of `sipconfig.Makefile.finalise()`.

`QtGLModuleMakefile(QtModuleMakefile)`

  The Makefile class for modules that import the `qtgl` module.

  `finalise(self)`

    This is a reimplementation of `sipconfig.Makefile.finalise()`.

`QtNetworkModuleMakefile(QtModuleMakefile)`

  The Makefile class for modules that import the `qtnetwork` module.

  `finalise(self)`

    This is a reimplementation of `sipconfig.Makefile.finalise()`.

`QtTableModuleMakefile(QtModuleMakefile)`

  The Makefile class for modules that import the `qttable` module.

  `finalise(self)`

    This is a reimplementation of `sipconfig.Makefile.finalise()`.

`QtSQLModuleMakefile(QtTableModuleMakefile)`

  The Makefile class for modules that import the `qtsql` module.

  `finalise(self)`

    This is a reimplementation of `sipconfig.Makefile.finalise()`.

`QtUIModuleMakefile(QtModuleMakefile)`

  The Makefile class for modules that import the `qtui` module.

  `finalise(self)`

    This is a reimplementation of `sipconfig.Makefile.finalise()`.

`QtXMLModuleMakefile(QtModuleMakefile)`

  The Makefile class for modules that import the `qtxml` module.

  `finalise(self)`

    This is a reimplementation of `sipconfig.Makefile.finalise()`.

## Things to be Aware Of

### Python Strings, Qt Strings and Unicode

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 `QString`s, 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 `QString`s 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.

### Access to Protected Member Functions

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.

### `None` and `NULL`

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.

### Support for C++ `void *` Data Types

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.

### Support for Threads

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 `import`s) 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.

### Garbage Collection

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 = QColor();
    c = 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)

### C++ Variables

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.

### Multiple Inheritance

It is not possible to define a new Python class that sub-classes from more than one Qt class.

### i18n Support

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()`.

## Signal and Slot Support

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 it's 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

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

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

## Module Reference Documentation

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.

## `qt` Module Reference

### Qt Constants

All constant values defined by Qt have equivalent constants defined to Python.

### Qt (Qt v2+)

`Qt` is fully implemented.

### QAccel

`QAccel` is fully implemented.

### QAction (Qt v2.2+)

`QAction` is fully implemented.

### QActionGroup (Qt v2.2+)

`QActionGroup` is fully implemented.

### QApplication

`QApplication`(int& argc, char **argv);

This takes one parameter which is a list of argument strings. Arguments used by Qt are removed from the list.

`QApplication`(int& argc, char **argv, bool GUIenabled);

Not implemented.

`QApplication`(int& argc, char **argv, Type type);

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+)

`int exec`();

This has been renamed to `exec_loop` in Python.

### QAssistantClient (Qt v3.1+)

`QAssistantClient` is fully implemented.

### QBitmap

`QBitmap` is fully implemented.

### QBrush

`QBrush` is fully implemented, including the Python `==` and `!=` operators.

### QButton

`QButton` is fully implemented.

### QButtonGroup

`QButtonGroup` is fully implemented.

### QByteArray

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.

`QByteArray &assign`(const char *data, uint size);

Not implemented.

`char &at`(uint i);

Not yet implemented.

`int contains`(const char &d);

Not yet implemented.

`bool fill`(const char &d, int size = -1);

Not yet implemented.

`int find`(const char &d, uint i = 0);

Not yet implemented.

`void resetRawData`(const char *data, uintsize);

Not implemented.

`QByteArray &setRawData`(const char *data, uintsize);

Not implemented.

### QCDEStyle (Qt v2+)

`QCDEStyle` is fully implemented.

### QCheckBox

`QCheckBox` is fully implemented.

### QClipboard

`void *data const`(const char *format);

Not yet implemented (Qt v1.x).

`void setData`(const char *format, void *);

Not yet implemented (Qt v1.x).

### QColor

The Python `==` and `!=` operators are supported.

`void getHsv`(int *h, int *s, int *v);

This takes no parameters and returns the `h`, `s` and `v` values as a tuple.

`void getRgb`(int *r, int *g, int *b);

This takes no parameters and returns the `r`, `g` and `b` values as a tuple.

`void hsv`(int *h, int *s, int *v);

This takes no parameters and returns the `h`, `s` and `v` values as a tuple.

`void rgb`(int *r, int *g, int *b);

This takes no parameters and returns the `r`, `g` and `b` values as a tuple.

### QColorDialog (Qt v2+)

`static QRgb getRgba`(QRgb initial, bool *ok, QWidget *parent = 0, const char *name = 0);

This takes the `initial`, `parent` and `name` parameters and returns a tuple containing the `QRgb` result and the `ok` value.

### QColorGroup

`QColorGroup` is fully implemented.

### QComboBox

`QComboBox` is fully implemented.

### QCommonStyle (Qt v2+)

`virtual void getButtonShift`(int &x, int &y);

This takes no parameters and returns a tuple of the `x` and `y` values. (Qt v2)

`virtual void tabbarMetrics`(const QTabBar *t, int &hframe, int &vframe, int &overlap);

This takes only the `t` parameter and returns a tuple of the `hframe`, `vframe` and `overlap` values. (Qt v2)

### QCString (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.

`QCString &sprintf`(const char *format, ...);

Not implemented.

`short toShort`(bool *ok = 0);

This returns a tuple of the `short` result and the `ok` value.

`ushort toUShort`(bool *ok = 0);

This returns a tuple of the `ushort` result and the `ok` value.

`int toInt`(bool *ok = 0);

This returns a tuple of the `int` result and the `ok` value.

`uint toUInt`(bool *ok = 0);

This returns a tuple of the `uint` result and the `ok` value.

`long toLong`(bool *ok = 0);

This returns a tuple of the `long` result and the `ok` value.

`ulong toULong`(bool *ok = 0);

This returns a tuple of the `ulong` result and the `ok` value.

`float toFloat`(bool *ok = 0);

This returns a tuple of the `float` result and the `ok` value.

`double toDouble`(bool *ok = 0);

This returns a tuple of the `double` result and the `ok` value.

### QCursor

`QCursor` is fully implemented.

### QDataStream

`QDataStream &readBytes`(const char *&s, uint &l);

This takes no parameters. The `QDataStream` result and the data read are returned as a tuple.

`QDataStream &readRawBytes`(const char *s, uint l);

This takes only the `l` parameter. The `QDataStream` result and the data read are returned as a tuple.

`QDataStream &writeBytes`(const char *s, uint len);

`len` is derived from `s` and not passed as a parameter.

`QDataStream &writeRawBytes`(const char *s, uint len);

`len` is derived from `s` and not passed as a parameter.

### QDate

The Python `==`, `!=`, `<`, `<=`, `>`, `>=` and `__nonzero__` operators are supported.

`int weekNumber`(int *yearNum = 0);

This takes no parameters and returns the week number and the year number as a tuple. (Qt v3.1+)

### QDateTime

`QDateTime` is fully implemented, including the Python `==`, `!=`, `<`, `<=`, `>`, `>=` and `__nonzero__` operators.

### QTime

`QTime` is fully implemented, including the Python `==`, `!=`, `<`, `<=`, `>`, `>=` and `__nonzero__` operators.

### QDateEdit (Qt v3+)

`QDateEdit` is fully implemented.

### QTimeEdit (Qt v3+)

`QTimeEdit` is fully implemented.

### QDateTimeEdit (Qt v3+)

`QDateTimeEdit` is fully implemented.

### QDesktopWidget (Qt v3+)

`QDesktopWidget` is fully implemented.

### QDial (Qt v2.2+)

`QDial` is fully implemented.

### QDialog

`int exec`();

This has been renamed to `exec_loop` in Python.

### QDir

`QDir` is fully implemented, including the Python `len`, `[]` (for reading slices and individual elements), `==`, `!=` and `in` operators

### QFileInfoList

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 instances is used instead.

### QDockArea (Qt v3+)

`bool hasDockWindow const`(QDockWindow *w, int *index = 0);

This takes the `w` parameter and returns the index of the QDockWIndow or -1 if the QDockArea does not contain the QDockWindow.

### QDockWindow (Qt v3+)

`QDockWindow` is fully implemented.

### QColorDrag (Qt v2.1+)

`QColorDrag` is fully implemented.

### QDragObject

`QDragObject` is fully implemented.

### QImageDrag

`QImageDrag` is fully implemented.

### QStoredDrag

`QStoredDrag` is fully implemented.

### QTextDrag

`QTextDrag` is fully implemented.

### QUriDrag (Qt v2+)

`QUriDrag` is fully implemented.

### QUrlDrag (Qt v1.x)

`QUrlDrag` is fully implemented.

### QDropSite

`QDropSite` is fully implemented.

### QErrorMessage (Qt v3+)

`QErrorMessage` is fully implemented.

### QEvent

`QEvent` is fully implemented.

Instances of `QEvent`s are automatically converted to the correct sub-class.

### QChildEvent

`QChildEvent` is fully implemented.

### QCloseEvent

`QCloseEvent` is fully implemented.

### QIconDragEvent (Qt v3.3+)

`QIconDragEvent` is fully implemented.

### QContextMenuEvent (Qt v3+)

`QContextMenuEvent` is fully implemented.

### QCustomEvent

`QCustomEvent` is fully implemented. Any Python object can be passed as the event data and its reference count is increased.

### QDragEnterEvent

`QDragEnterEvent` is fully implemented.

### QDragLeaveEvent

`QDragLeaveEvent` is fully implemented.

### QDragMoveEvent

`QDragMoveEvent` is fully implemented.

### QDropEvent

`QDropEvent` is fully implemented.

### QFocusEvent

`QFocusEvent` is fully implemented.

### QHideEvent

`QHideEvent` is fully implemented.

### QIMComposeEvent (Qt v3.1+)

`QIMComposeEvent` is fully implemented.

### QIMEvent (Qt v3+)

`QIMEvent` is fully implemented.

### QKeyEvent

`QKeyEvent` is fully implemented.

### QMouseEvent

`QMouseEvent` is fully implemented.

### QMoveEvent

`QMoveEvent` is fully implemented.

### QPaintEvent

`QPaintEvent` is fully implemented.

### QResizeEvent

`QResizeEvent` is fully implemented.

### QShowEvent

`QShowEvent` is fully implemented.

### QTabletEvent (Qt v3+)

`QTabletEvent` is fully implemented.

### QTimerEvent

`QTimerEvent` is fully implemented.

### QWheelEvent (Qt v2+)

`QWheelEvent` is fully implemented.

### QEventLoop (Qt v3.1+)

`virtual int exec`();

This has been renamed to `exec_loop` in Python.

### QFile

`bool open`(int m, FILE *f);

Not implemented.

`Q_LONG readBlock`(char *data, Q_ULONG len);

This takes a single `len` parameter. The `data` is returned if there was no error, otherwise `None` is returned.

`Q_LONG readLine`(char *data, Q_ULONG maxlen);

This takes a single `maxlen` parameter. The `data` is returned if there was no error, otherwise `None` is returned.

`static void setDecodingFunction`(EncoderFn f);

Not yet implemented. (Qt v2+)

`static void setEncodingFunction`(EncoderFn f);

Not yet implemented. (Qt v2+)

`Q_LONG writeBlock`(const char *data, Q_ULONG len);

`len` is derived from `data` and not passed as a parameter.

### QFileDialog

`QFileDialog` is fully implemented.

### QFileIconProvider

`QFileIconProvider` is fully implemented.

### QFilePreview

`QFilePreview` is fully implemented.

### QFileInfo

`QFileInfo` is fully implemented.

### QFont

`QFont` is fully implemented, including the Python `==` and `!=` operators.

### QFontDatabase (Qt v2.1+)

`QFontDatabase` is fully implemented.

### QFontDialog (Qt v2+)

`static QFont getFont`(bool *ok, const QFont &def, QWidget *parent = 0, const char *name = 0);

This takes the `def`, `parent` and `name` parameters and returns a tuple containing the `QFont` result and the `ok` value.

`static QFont getFont`(bool *ok, QWidget *parent = 0, const char *name = 0);

This takes the `parent` and `name` parameters and returns a tuple containing the `QFont` result and the `ok` value.

### QFontInfo

`QFontInfo` is fully implemented.

### QFontMetrics

`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.

`QSize size`(int flags, const QString &str, int len = -1, int tabstops = 0, int *tabarray = 0);

The `tabarray` parameter is a Python list of integers.

### QFrame

`QFrame` is fully implemented.

### QGManager (Qt v1.x)

`QGManager` is fully implemented.

### QChain (Qt v1.x)

`QChain` is implemented as an opaque class.

### QGrid (Qt v2+)

`QGrid` is fully implemented.

### QGridView (Qt v3+)

`QGridView` is fully implemented.

### QGroupBox

`QGroupBox` is fully implemented.

### QHBox (Qt v2+)

`QHBox` is fully implemented.

### QHButtonGroup (Qt v2+)

`QHButtonGroup` is fully implemented.

### QHeader

`QHeader` is fully implemented.

### QHGroupBox (Qt v2+)

`QHGroupBox` is fully implemented.

### QIconSet

`QIconSet` is fully implemented.

### QIconFactory (Qt v3.1+)

`QIconFactory` is fully implemented.

### QIconView (Qt v2.1+)

`QIconViewItem *makeRowLayout`(QIconViewItem *begin, int &y);

Not yet implemented.

### QIconViewItem (Qt v2.1+)

`QIconViewItem` is fully implemented.

### QIconDrag (Qt v2.1+)

`QIconDrag` is fully implemented.

### QIconDragItem (Qt v2.1+)

`QIconDragItem` is fully implemented.

### QImage

The Python `==` and `!=` operators are supported.

`QImage`(const char *xpm[]);

This takes a list of strings as its parameter.

`QImage`(uchar *data, int w, int h, int depth, QRgb *colorTable, int numColors, Endian bitOrder);

The `colorTable` parameter is a list of QRgb instances or None. (Qt v2.1+)

`uchar *bits`();

The return value is a `sip.voidptr` object which is only useful if passed to another Python module.

`QRgb *colorTable`();

The return value is a `sip.voidptr` object which is only useful if passed to another Python module.

`QImage convertDepthWithPalette`(int, QRgb *p, int pc, int cf = 0);

Not implemented.

`uchar **jumpTable`();

The return value is a `sip.voidptr` object which is only useful if passed to another Python module.

`bool loadFromData`(const uchar *buf, uint len, const char *format = 0, ColorMode mode = Auto);

`len` is derived from `buf` and not passed as a parameter.

`uchar *scanLine`(int i);

The return value is a `sip.voidptr` object which is only useful if passed to another Python module.

### QImageIO

`static void defineIOHandler`(const char *format, const char *header, const char *flags, image_io_handler read_image, image_io_handler write_image);

Not implemented.

### QImageTextKeyLang

`QImageTextKeyLang` is fully implemented.

### QInputDialog (Qt v2.1+)

`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.

### QInterlaceStyle (Qt v2.3.1+)

`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.

### QIODevice

`QIODevice` is fully implemented.

### QKeySequence (Qt v3+)

`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.

### QLabel

`QLabel` is fully implemented.

### QLayout

`QLayout` is fully implemented.

### QBoxLayout

`QBoxLayout` is fully implemented.

### QGLayoutIterator (Qt v2+)

`QGLayoutIterator` is fully implemented.

### QGridLayout

`bool findWidget`(QWidget *w, int *row, int *col);

This takes the `w` parameter and returns a tuple containing the `bool` result, `row` and `col`. (Qt v2+)

### QHBoxLayout

`QHBoxLayout` is fully implemented.

### QLayoutItem (Qt v2+)

`QLayoutItem` is fully implemented.

### QLayoutIterator (Qt v2+)

`QLayoutItem *next`();

This is a wrapper around the `QLayoutIterator` `++` operator.

### QSpacerItem (Qt v2+)

`QSpacerItem` is fully implemented.

### QVBoxLayout

`QVBoxLayout` is fully implemented.

### QWidgetItem (Qt v2+)

`QWidgetItem` is fully implemented.

### QLCDNumber

`QLCDNumber` is fully implemented.

### QLibrary (Qt v3+)

`QLibrary` is fully implemented.

### QLineEdit

`int characterAt`(int xpos, QChar *chr);

This takes only the `xpos` parameter and returns the int result and the `chr` value as a tuple. (Qt v3+)

`void del`();

This has been renamed `delChar` in Python. (Qt v2+)

`bool getSelection`(int *start, int *end);

This takes no parameters and returns the bool result and the `start` and `end` values as a tuple. (Qt v3+)

### QList<type> (Qt v2)

Types based on the `QList` template are automatically converted to and from Python lists of the type.

### QListBox

`bool itemYPos`(int index, int *yPos);

This takes the `index` parameter and returns a tuple containing the `bool` result and `yPos`. (Qt v1.x)

### QListBoxItem

`QListBoxItem` is fully implemented.

### QListBoxPixmap

`QListBoxPixmap` is fully implemented.

### QListBoxText

`QListBoxText` is fully implemented.

### QListView

`QListView` is fully implemented.

Note that to remove a child `QListViewItem` you must first call `takeItem()` and then `del()`.

### QListViewItem

`QListViewItem` is fully implemented.

Note that to remove a child `QListViewItem` you must first call `takeItem()` and then `del()`.

### QCheckListItem

`QCheckListItem` is fully implemented.

### QListViewItemIterator (Qt v2+)

`QListViewItemIterator` is fully implemented.

### QLocale (Qt v3.3+)

`short toShort`(bool *ok = 0);

This returns a tuple of the `short` result and the `ok` value.

`ushort toUShort`(bool *ok = 0);

This returns a tuple of the `ushort` result and the `ok` value.

`int toInt`(bool *ok = 0);

This returns a tuple of the `int` result and the `ok` value.

`uint toUInt`(bool *ok = 0);

This returns a tuple of the `uint` result and the `ok` value.

`Q_LONG toLong`(bool *ok = 0);

This returns a tuple of the `long` result and the `ok` value.

`Q_ULONG toULong`(bool *ok = 0);

This returns a tuple of the `ulong` result and the `ok` value.

`float toFloat`(bool *ok = 0);

This returns a tuple of the `float` result and the `ok` value.

`double toDouble`(bool *ok = 0);

This returns a tuple of the `double` result and the `ok` value.

### QMainWindow

`QTextStream &operator<<`(QTextStream &, const QMainWindow &);

This operator is fully implemented. (Qt v3+)

`QTextStream &operator>>`(QTextStream &, QMainWindow &);

This operator is fully implemented. (Qt v3+)

`bool getLocation`(QToolBar *tb, ToolBarDock &dock, int &index, bool &nl, int &extraOffset);

This takes only the `tb` parameter and returns a tuple of the result, `dock`, `index`, `nl` and `extraOffset` values. (Qt v2.1.0+)

`QList<QToolBar> toolBars`(ToolBarDock dock);

This returns a list of `QToolBar` instances. (Qt v2.1.0+)

### QMemArray<type> (Qt v3+)

Types based on the `QMemArray` template are automatically converted to and from Python lists of the type.

### QMenuBar

`QMenuBar` is fully implemented.

### QMenuData

`QMenuItem *findItem`(int id, QMenuData **parent);

Not implemented.

### QCustomMenuItem (Qt v2.1+)

`QCustomMenuItem` is fully implemented.

### QMenuItem

`QMenuItem` is an internal Qt class.

### QMessageBox

`QMessageBox` is fully implemented.

### QMetaObject

`int numClassInfo const`(bool super = FALSE);

Not implemented.

`const QClassInfo *classInfo const`(bool super = FALSE);

Not implemented.

### QMetaProperty

`QMetaProperty` is fully implemented.

### QMimeSource (Qt v2+)

`QMimeSource` is fully implemented.

### QMimeSourceFactory (Qt v2+)

`QMimeSourceFactory` is fully implemented.

### QWindowsMime (Qt v3+)

`QWindowsMime` is fully implemented.

### QMotifPlusStyle (Qt v2.2+)

`void getButtonShift`(int &x, int &y);

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)

### QMotifStyle (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)

`void tabbarMetrics`(const QTabBar *t, int &hframe, int &vframe, int &overlap);

This takes only the `t` parameter and returns a tuple of the `hframe`, `vframe` and `overlap` values. (Qt v2)

### QMovie

`QMovie`(QDataSource *src, int bufsize = 1024);

Not implemented.

`void pushData`(const uchar *data, int length);

`length` is derived from `data` and not passed as a parameter. (Qt v2.2.0+)

### QMultiLineEdit

`void cursorPosition const`(int *line, int *col);

This takes no parameters and returns a tuple of the `line` and `col` values. (Qt v1.x, Qt v2.x)

`virtual void del`();

This has been renamed `delChar` in Python. (Qt v1.x, Qt v2.x)

`void getCursorPosition const`(int *line, int *col);

This takes no parameters and returns a tuple of the `line` and `col` values. (Qt v1.x, Qt v2.x)

`bool getMarkedRegion`(int *line1, int *col1, int *line2, int *col2);

This takes no parameters and returns a tuple of the bool result and the `line1`, `col1`, `line2` and `col2` values.

### QMutex (Qt v2.2+)

`QMutex` is fully implemented.

### QMutexLocker (Qt v3.1+)

`QMutexLocker` is fully implemented.

### QNetworkOperation (Qt v2.1+)

`QNetworkOperation` is fully implemented.

### QNetworkProtocol (Qt v2.1+)

`QNetworkProtocol` is fully implemented.

### QNetworkProtocolFactoryBase (Qt v2.1+)

`QNetworkProtocolFactoryBase` is fully implemented.

### QObject

`bool disconnect`(const QObject *receiver, const char *member = 0);

Not yet implemented.

`bool disconnect`(const char *signal = 0, const QObject *receiver = 0, const char *member = 0);

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.

### QObjectCleanupHandler (Qt v3+)

`QObjectCleanupHandler` is fully implemented.

### QObjectList

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.

### QPaintDeviceMetrics

`QPaintDeviceMetrics` is fully implemented.

### QPaintDevice

`virtual bool cmd`(int, QPainter *, QPDevCmdParam *);

Not implemented.

### QPainter

`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.

`QRect boundingRect`(const QRect&, int flags, const char *str, int len = -1, char **intern = 0);

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.

`void setTabArray`(int *ta);

This takes a single parameter which is a list of tab stops.

`int *tabArray`();

This returns a list of tab stops.

### QPalette

`QPalette` is fully implemented, including the Python `==` and `!=` operators.

### QPixmap

`QPixmap`(const char *xpm[]);

This takes a list of strings as its parameter.

`bool loadFromData`(const uchar *buf, uint len, const char *format = 0, ColorMode mode = Auto);

`len` is derived from `buf` and not passed as a parameter.

`bool loadFromData`(const uchar *buf, uint len, const char *format, int conversion_flags);

Not implemented.

### QPixmapCache (Qt v3+)

`QPixmapCache` is fully implemented.

### QPair<type,type> (Qt v3+)

Types based on the `QPair` template are automatically converted to and from Python tuples of two elements.

### QPen

`QPen` is fully implemented, including the Python `==` and `!=` operators.

### QPicture

`const char *data`();

Not implemented.

`void setData`(const char *data, uint size);

`size` is derived from `data` and not passed as a parameter.

### QPlatinumStyle (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)

### QPoint

The Python `+`, `+=`, `-`, `-=`, unary `-`, `*`, `*=`, `/`, `/=`, `==`, `!=` and `__nonzero__` operators are supported.

`QCOORD &rx`();

Not implemented.

`QCOORD &ry`();

Not implemented.

### QPointArray

`QPointArray`(int nPoints, const QCOORD *points);

This takes a single parameter which is a list of points.

`void point`(uint i, int *x, int *y);

This takes the single parameter `i` and returns the `x` and `y` values as a tuple.

`bool putPoints`(int index, int nPoints, const QCOORD *points);

This takes two parameters, `index` and a list of points.

`bool putPoints`(int index, int nPoints, int firstx, int firsty, ...);

Not implemented.

`bool setPoints`(int nPoints, const QCOORD *points);

This takes a single parameter which is a list of points.

`bool setPoints`(int nPoints, int firstx, int firsty, ...);

Not implemented.

### QPopupMenu

`int exec`();

This has been renamed `exec_loop` in Python.

`int exec`(const QPoint &pos, int indexAtPoint = 0);

This has been renamed `exec_loop` in Python.

### QPrintDialog (X11)

`QPrintDialog` is fully implemented.

### QPrinter

`QPrinter` is fully implemented.

### QProcess (Qt v3+)

`QProcess` is fully implemented.

### QProgressBar

`QProgressBar` is fully implemented.

### QProgressDialog

`QProgressDialog` is fully implemented. value.

### QPtrList<type> (Qt v3+)

Types based on the `QPtrList` template are automatically converted to and from Python lists of the type.

### QPushButton

`QPushButton` is fully implemented.

### QRadioButton

`QRadioButton` is fully implemented.

### QRangeControl

`QRangeControl` is fully implemented.

### QRect

The Python `&`, `&=`, `|`, `|=`, `==`, `!=`, `in` and `__nonzero__` operators are supported.

`void coords`(int *x1, int *y1, int *x2, int *y2);

This takes no parameters and returns a tuple containing the four values.

`void rect`(int *x, int *y, int *w, int *h);

This takes no parameters and returns a tuple containing the four values.

`QCOORD &rBottom`();

Not implemented. (Qt v2+)

`QCOORD &rLeft`();

Not implemented. (Qt v2+)

`QCOORD &rRight`();

Not implemented. (Qt v2+)

`QCOORD &rTop`();

Not implemented. (Qt v2+)

### QRegExp

The Python `==` and `!=` operators are supported.

`int match`(const char *str, int index = 0, int *len = 0);

This takes `str` and `index` parameters and returns a tuple of the `int` result and the `len` value. (Qt v1.x)

`int match`(const QString &str, int index = 0, int *len = 0);

This takes `str` and `index` parameters and returns a tuple of the `int` result and the `len` value. (Qt v2+)

### QRegion

The Python `|`, `|=`, `+`, `+=`, `&`, `&=`, `-`, `-=`, `^`, `^=`, `==`, `!=`, `in` and `__nonzero__` operators are supported.

`QArray<QRect> rects`();

Not implemented.

`void setRects`(QRect *rects, int num);

Not yet implemented. (Qt v2.2+)

### QScrollBar

`QScrollBar` is fully implemented.

### QScrollView

`void contentsToViewport`(int x, int y, int &vx, int &vy);

This takes the `x` and `y` parameters and returns a tuple containing the `vx` and `vy` values. (Qt v2+)

`void viewportToContents`(int vx, int vy, int &x, int &y);

This takes the `vx` and `vy` parameters and returns a tuple containing the `x` and `y` values. (Qt v2+)

### QSemaphore (Qt v2.2+)

`QSemaphore` is fully implemented. The `+=` and `-=` operators have also been implemented, but require Python v2.0 or later.

### QSemiModal (Qt v1, v2)

`QSemiModal` is fully implemented.

### QSessionManager (Qt v2+)

`QSessionManager` is fully implemented.

### QSettings (Qt v3+)

`bool readBoolEntry`(const QString &key, bool def = 0, bool *ok = 0);

The `ok` is not passed and the returned value is a tuple of the `bool` result and the `ok` flag.

`double readDoubleEntry`(const QString &key, double def = 0, bool *ok = 0);

The `ok` is not passed and the returned value is a tuple of the `double` result and the `ok` flag.

`QString readEntry`(const QString &key, const QString &def = QString::null, bool *ok = 0);

The `ok` is not passed and the returned value is a tuple of the `QString` result and the `ok` flag.

`QStringList readListEntry`(const QString &key, bool *ok = 0);

The `ok` is not passed and the returned value is a tuple of the `QStringList` result and the `ok` flag.

`QStringList readListEntry`(const QString &key, const QChar &separator, bool *ok = 0);

The `ok` is not passed and the returned value is a tuple of the `QStringList` result and the `ok` flag.

`int readNumEntry`(const QString &key, int def = 0, bool *ok = 0);

The `ok` is not passed and the returned value is a tuple of the `int` result and the `ok` flag.

`bool writeEntry`(const QString &key, bool value);

Not implemented.

### QSGIStyle (Qt v2.2+)

`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)

### QSignalMapper

`QSignalMapper` is fully implemented.

### QSimpleRichText (Qt v2+)

`QSimpleRichText` is fully implemented.

### QSize

The Python `+`, `+=`, `-`, `-=`, `*`, `*=`, `/`, `/=`, `==`, `!=` and `__nonzero__` operators are supported.

`QCOORD &rheight`();

Not implemented.

`QCOORD &rwidth`();

Not implemented.

### QSizeGrip (Qt v2+)

`QSizeGrip` is fully implemented.

### QSizePolicy (Qt v2+)

`QSizePolicy` is fully implemented.

### QSlider

`QSlider` is fully implemented.

### QSocketNotifier

`QSocketNotifier` is fully implemented.

### QSound (Qt v2.2+)

`QSound` is fully implemented.

### QSpinBox

`virtual int mapTextToValue`(bool *ok);

This returns a tuple of the `int` result and the modified `ok` value.

### QSplashScreen (Qt v3.2.0+)

`QSplashScreen` is fully implemented.

### QSplitter

`void getRange`(int id, int *min, int *max);

This takes the `id` parameter and returns the `min` and `max` values as a tuple. (Qt v2+)

### QStatusBar

`QStatusBar` is fully implemented.

### QChar (Qt v2+)

`uchar &cell const`();

Not implemented.

`uchar &row const`();

Not implemented.

### QString

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.

`QCharRef at`(uint i);

Not yet implemented. (Qt v2+)

`QChar constref const`(uint i);

Not yet implemented. (Qt v2+)

`QChar &ref`(uint i);

Not yet implemented. (Qt v2+)

`QString &setUnicodeCodes`(const ushort *unicode_as_shorts, uint len);

Not yet implemented. (Qt v2.1+)

`QString &sprintf`(const char *format, ...);

Not implemented.

`short toShort`(bool *ok = 0);

This returns a tuple of the `short` result and the `ok` value.

`ushort toUShort`(bool *ok = 0);

This returns a tuple of the `ushort` result and the `ok` value.

`int toInt`(bool *ok = 0);

This returns a tuple of the `int` result and the `ok` value.

`uint toUInt`(bool *ok = 0);

This returns a tuple of the `uint` result and the `ok` value.

`long toLong`(bool *ok = 0);

This returns a tuple of the `long` result and the `ok` value.

`ulong toULong`(bool *ok = 0);

This returns a tuple of the `ulong` result and the `ok` value.

`float toFloat`(bool *ok = 0);

This returns a tuple of the `float` result and the `ok` value.

`double toDouble`(bool *ok = 0);

This returns a tuple of the `double` result and the `ok` value.

### QStringList (Qt v2+)

The Python `len`, `[]` (for both reading and writing slices and individual elements), `del` (for deleting slices and individual elements), `+`, `+=`, `*`, `*=`, `==`, `!=` and `in` operators are supported.

`Iterator append`(const QString &x);

This does not return a value.

`Iterator prepend`(const QString &x);

This does not return a value.

### QStrList

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.

### QStyle (Qt v2+)

`virtual void getButtonShift`(int &x, int &y);

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)

`virtual void tabbarMetrics`(const QTabBar *t, int &hframe, int &vframe, int &overlap);

This takes only the `t` parameter and returns a tuple of the `hframe`, `vframe` and `overlap` values. (Qt v2)

### QStyleOption (Qt v3+)

`QStyleOption` is fully implemented.

### QStyleSheet (Qt v2+)

`QStyleSheet` is fully implemented.

### QStyleSheetItem (Qt v2+)

`QStyleSheetItem` is fully implemented.

### QSyntaxHighlighter (Qt v3.1+)

`QSyntaxHighlighter` is fully implemented.

### QTab

`QTab` is fully implemented.

### QTabBar

`QList<QTab> tabList`();

This returns a list of `QTab` instances.

### QTabDialog

`QTabDialog` is fully implemented.

### QTableView (Qt 1.x, Qt 2.x)

`bool colXPos`(int col, int *xPos);

This takes the `col` parameter and returns a tuple containing the `bool` result and `xPos`.

`bool rowYPos`(int row, int *yPos);

This takes the `row` parameter and returns a tuple containing the `bool` result and `yPos`.

### QTabWidget (Qt v2+)

`QTabWidget` is fully implemented.

### QTextBrowser (Qt v2+)

`QTextBrowser` is fully implemented.

### QTextCodec (Qt v2+)

`virtual QCString fromUnicode`(const QString &uc, int &lenInOut);

The returned value is a tuple of the `QCString` result and the updated `lenInOut`.

### QTextDecoder (Qt v2+)

`QTextDecoder` is fully implemented.

### QTextEncoder (Qt v2+)

`virtual QCString fromUnicode = 0`(const QString &uc, int &lenInOut);

The returned value is a tuple of the `QCString` result and the updated `lenInOut`.

### QTextEdit (Qt v3+)

`int charAt`(const QPoint &pos, int *para = 0);

This takes only the `pos` parameter and returns a tuple of the value returned via the `para` pointer and the int result.

`void del`();

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.

`void getCursorPosition`(int *para, int *index);

This takes no parameters and returns a tuple of the values returned via the `para` and `index` pointers.

`void getSelection`(int *paraFrom, int *indexFrom, int *paraTo, int *indexTo, int selNum = 0);

This takes only the `selNum` parameter and returns a tuple of the `paraFrom`, `indexFrom`, `paraTo` and `indexTo` values.

### QTextStream

`QTextStream`(FILE *fp, int mode);

Not implemented.

`QTextStream &readRawBytes`(char *buf, uint len);

Not yet implemented.

`QTextStream &writeRawBytes`(const char *buf, uint len);

Not yet implemented.

### QTextIStream (Qt v2+)

`QTextIStream`(FILE *fp, int mode);

Not implemented.

### QTextOStream (Qt v2+)

`QTextOStream`(FILE *fp, int mode);

Not implemented.

### QTextView (Qt v2+)

`QTextView` is fully implemented.

### QThread (Qt v2.2+)

`QThread` is fully implemented.

### QTimer

`QTimer` is fully implemented.

### QToolBar

`QToolBar` is fully implemented.

### QToolBox (Qt v3.2.0+)

`QToolBox` is fully implemented.

### QToolButton

`QToolButton` is fully implemented.

### QToolTip

`QToolTip` is fully implemented.

### QToolTipGroup

`QToolTipGroup` is fully implemented.

### QTranslator (Qt v2+)

`QTranslator` is fully implemented.

### QTranslatorMessage (Qt v2.2+)

`QTranslatorMessage` is fully implemented.

### QUrl (Qt v2.1+)

`QUrl` is fully implemented, including the `QString()`, `==` and `!=` operators.

### QUrlInfo (Qt v2.1+)

`QUrlInfo` is fully implemented.

### QUrlOperator (Qt v2.1+)

`virtual bool isDir`(bool *ok);

This returns a tuple of the `bool` result and the `ok` value.

### QUuid (Qt v3.0+)

`QUuid` is fully implemented.

### QValidator

`virtual State validate`(QString& input, int& pos);

The returned value is a tuple of the `State` result and the updated `pos`.

### QDoubleValidator

`State validate`(QString& input, int& pos);

The returned value is a tuple of the `State` result and the updated `pos`.

### QIntValidator

`State validate`(QString& input, int& pos);

The returned value is a tuple of the `State` result and the updated `pos`.

### QRegExpValidator (Qt v3+)

`virtual State validate`(QString& input, int& pos);

The returned value is a tuple of the `State` result and the updated `pos`.

### QValueList<type> (Qt v2+)

Types based on the `QValueList` template are automatically converted to and from Python lists of the type.

### QVariant (Qt v2.1+)

`QVariant`(const char *val);

Not implemented.

`QVariant`(const QBitArray &val);

Not yet implemented. (Qt v3+)

`QVariant`(const QValueList<QVariant> &val);

Not yet implemented.

`QVariant`(const QMap<QString,QVariant> &val);

Not yet implemented.

`QBitArray &asBitArray`();

Not yet implemented. (Qt v3+)

`bool &asBool`();

Not implemented.

`double &asDouble`();

Not implemented.

`int &asInt`();

Not implemented.

`QValueList<QVariant> &asList`();

Not implemented.

`QMap<QString,QVariant> &asMap`();

Not implemented.

`uint &asUInt`();

Not implemented.

`QValueListConstIterator<QVariant>listBegin const`();

Not implemented.

`QValueListConstIterator<QVariant>listEnd const`();

Not implemented.

`QMapConstIterator<QString,QVariant>mapBegin const`();

Not implemented.

`QMapConstIterator<QString,QVariant>mapEnd const`();

Not implemented.

`QMapConstIterator<QString,QVariant>mapFind const`(const QString &key);

Not implemented.

`QValueListConstIterator<QString>stringListBegin const`();

Not implemented.

`QValueListConstIterator<QString>stringListEnd const`();

Not implemented.

`const QBitArray toBitArray const`();

Not yet implemented. (Qt v3+)

`const QValueList<QVariant>toList const`();

Not yet implemented.

`const QMap<QString,QVariant>toMap const`();

Not yet implemented.

### QVBox (Qt v2+)

`QVBox` is fully implemented.

### QVButtonGroup (Qt v2+)

`QVButtonGroup` is fully implemented.

### QVGroupBox (Qt v2+)

`QVGroupBox` is fully implemented.

### QWaitCondition (Qt v2.2+)

`QWaitCondition` is fully implemented.

### QWhatsThis

`QWhatsThis` is fully implemented.

### QWidget

`QWExtra *extraData`();

Not implemented.

`QFocusData *focusData`();

Not implemented.

`void lower`();

This has been renamed to `lowerW` in Python.

`void raise`();

This has been renamed to `raiseW` in Python.

### QWidgetList

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.

### QWidgetStack

`QWidgetStack` is fully implemented.

### QWindow

`QWindow` is fully implemented (Qt v1.x).

### QWindowsStyle (Qt v2+)

`void getButtonShift`(int &x, int &y);

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)

`void tabbarMetrics`(const QTabBar *t, int &hframe, int &vframe, int &overlap);

This takes only the `t` parameter and returns a tuple of the `hframe`, `vframe` and `overlap` values. (Qt v2)

### QWindowsXPStyle (Qt v3.0.1+, Windows)

`QWindowsXPStyle` is fully implemented.

### QWizard (Qt v2+)

`QWizard` is fully implemented.

### QWMatrix

The Python `==`, `!=` and `*=` operators are supported.

`QWMatrix invert const`(bool *invertible = 0);

This takes no parameters and returns a tuple of the `QWMatrix` result and the `invertible` value.

`void map const`(int x, int y, int *tx, int *ty);

This takes the `x` and `y` parameters and returns a tuple containing the `tx` and `ty` values.

`void map const`(float x, float y, float *tx, float *ty);

This takes the `x` and `y` parameters and returns a tuple containing the `tx` and `ty` values. (Qt v1.x)

`void map const`(double x, double y, double *tx, double *ty);

This takes the `x` and `y` parameters and returns a tuple containing the `tx` and `ty` values. (Qt v2+)

### QWorkspace (Qt v2.1+)

`QWorkspace` is fully implemented.

## `qtaxcontainer` Module Reference

### QAxObject (Windows, Qt v3+)

Note that support for this class is currently considered experimental.

### QAxWidget (Windows, Qt v3+)

Note that support for this class is currently considered experimental.

## `qtcanvas` Module Reference

### QCanvas (Qt v2.2+)

`QCanvas` is fully implemented.

### QCanvasEllipse (Qt v2.2+)

`QCanvasEllipse` is fully implemented.

### QCanvasItem (Qt v2.2+)

`QCanvasItem` is fully implemented.

### QCanvasItemList (Qt v2.2+)

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.

### QCanvasLine (Qt v2.2+)

`QCanvasLine` is fully implemented.

### QCanvasPixmap (Qt v2.2+)

`QCanvasPixmap` is fully implemented.

### QCanvasPixmapArray (Qt v2.2+)

`QPixmapArray`(QList<QPixmap> pixmaps, QList<QPoint> hotspots);

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)

`QPixmapArray`(QValueList<QPixmap> pixmaps, QPointArray hotspots = QPointArray());

The `pixmaps` argument is a Python list of QPixmap instances. (Qt v3+)

### QCanvasPolygon (Qt v2.2+)

`QCanvasPolygon` is fully implemented.

### QCanvasPolygonalItem (Qt v2.2+)

`QCanvasPolygonalItem` is fully implemented.

### QCanvasRectangle (Qt v2.2+)

`QCanvasRectangle` is fully implemented.

### QCanvasSpline (Qt v3.0+)

`QCanvasSpline` is fully implemented.

### QCanvasSprite (Qt v2.2+)

`QCanvasSprite` is fully implemented.

### QCanvasText (Qt v2.2+)

`QCanvasText` is fully implemented.

### QCanvasView (Qt v2.2+)

`QCanvasView` is fully implemented.

## `qtext` Module Reference

### QextScintilla

`void getCursorPosition`(int *line, int *index);

This takes no parameters and returns a tuple of the values returned by the `line` and `index` pointers.

`void getSelection`(int *lineFrom, int *indexFrom, int *lineTo, int *indexTo);

This takes no parameters and returns a tuple of the values returned by the `lineFrom`, `indexFrom`, `lineTo` and `indexTo` pointers.

### QextScintillaAPIs

`QextScintillaAPIs` is fully implemented.

### QextScintillaBase

`QextScintillaBase` is fully implemented.

### QextScintillaCommand

`QextScintillaCommand` is fully implemented.

### QextScintillaCommandSet

`QextScintillaCommandSet` is fully implemented.

### QextScintillaDocument

`QextScintillaDocument` is fully implemented.

### QextScintillaLexer

`QextScintillaLexer` is fully implemented.

### QextScintillaLexerBash

`QextScintillaLexerBash` is fully implemented.

### QextScintillaLexerCPP

`QextScintillaLexerCPP` is fully implemented.

### QextScintillaLexerCSharp

`QextScintillaLexerCSharp` is fully implemented.

### QextScintillaLexerHTML (QScintilla v1.1+)

`QextScintillaLexerHTML` is fully implemented.

### QextScintillaLexerIDL

`QextScintillaLexerIDL` is fully implemented.

### QextScintillaLexerJava

`QextScintillaLexerJava` is fully implemented.

### QextScintillaLexerJavaScript

`QextScintillaLexerJavaScript` is fully implemented.

### QextScintillaLexerPerl

`QextScintillaLexerPerl` is fully implemented.

### QextScintillaLexerPython

`QextScintillaLexerPython` is fully implemented.

### QextScintillaLexerSQL (QScintilla v1.1+)

`QextScintillaLexerSQL` is fully implemented.

### QextScintillaMacro

`QextScintillaMacro` is fully implemented.

### QextScintillaPrinter

`QextScintillaPrinter` is fully implemented.

## `qtgl` Module Reference

### QGL

`QGL` is fully implemented.

### QGLContext

`QGLContext` is fully implemented.

### QGLFormat

`QGLFormat` is fully implemented.

### QGLWidget

`QGLWidget` is fully implemented.

### QGLColormap (Qt v3.0+)

`void setEntries`(int count, const QRgb *colors, int base = 0);

Not yet implemented.

## `qtnetwork` Module Reference

### QDns (Qt v2.2+)

`QDns` is fully implemented.

### QFtp (Qt v2.2+)

`Q_LONG readBlock`(char *data, Q_ULONG maxlen);

This takes a single `maxlen` parameter. The `data` is returned if there was no error, otherwise `None` is returned.

### QHostAddress (Qt v2.2+)

`QHostAddress`(Q_UINT8 *ip6Addr);

Not yet implemented.

`QHostAddress`(const Q_IPV6ADDR &ip6Addr);

Not yet implemented.

`void setAddress`(Q_UINT8 *ip6Addr);

Not yet implemented.

`Q_IPV6ADDR toIPv6Address const`();

Not yet implemented.

### QHttp (Qt v3+)

`Q_LONG readBlock`(char *data, Q_ULONG maxlen);

This takes a single `maxlen` parameter. The `data` is returned if there was no error, otherwise `None` is returned.

### QHttpHeader (Qt v3.1+)

`QHttpHeader` is fully implemented.

### QHttpRequestHeader (Qt v3.1+)

`QHttpRequestHeader` is fully implemented.

### QHttpResponseHeader (Qt v3.1+)

`QHttpResponseHeader` is fully implemented.

### QLocalFs (Qt v2.1+)

`QLocalFs` is fully implemented.

### QServerSocket (Qt v2.2+)

`QServerSocket` is fully implemented.

### QSocket (Qt v2.2+)

`Q_LONG readBlock`(char *data, Q_ULONG len);

This takes a single `len` parameter. The `data` is returned if there was no error, otherwise `Py_None` is returned.

`Q_LONG readLine`(char *data, Q_ULONG maxlen);

This takes a single `maxlen` parameter. The `data` is returned if there was no error, otherwise `Py_None` is returned.

`Q_LONG writeBlock`(const char *data, Q_ULONG len);

`len` is derived from `data` and not passed as a parameter.

### QSocketDevice (Qt v2.2+)

`Q_LONG readBlock`(char *data, Q_ULONG len);

This takes a single `len` parameter. The `data` is returned if there was no error, otherwise `None` is returned.

`Q_LONG writeBlock`(const char *data, Q_ULONG len);

`len` is derived from `data` and not passed as a parameter.

## `qtpe` Module Reference

### QPEApplication

`QApplication`(int& argc, char **argv, Type type);

This takes two parameters, the first of which is a list of argument strings. Arguments used by Qt are removed from the list.

`int exec`();

This has been renamed to `exec_loop` in Python.

### AppLnk

`virtual QString exec const`();

This has been renamed to `exec_property` in Python.

### AppLnkSet

`AppLnkSet` is fully implemented.

### Config

`Config` is fully implemented.

### DateFormat

`DateFormat` is fully implemented.

### DocLnk

`QString exec const`();

This has been renamed to `exec_property` in Python.

### DocLnkSet

`DocLnkSet` is fully implemented.

### FileManager

`FileManager` is fully implemented.

### FileSelector

`FileSelector` is fully implemented.

### FileSelectorItem

`FileSelectorItem` is fully implemented.

### FontDatabase

`FontDatabase` is fully implemented.

### Global

`static void setBuiltinCommands`(Command *);

Not implemented.

### MenuButton

`MenuButton` is fully implemented.

### QCopEnvelope

`QCopEnvelope` is fully implemented.

### QDawg

`QDawg` is fully implemented.

### QPEMenuBar

`QPEMenuBar` is fully implemented.

### QPEToolBar

`QPEToolBar` is fully implemented.

### Resource

`Resource` is fully implemented.

## `qtsql` Module Reference

### QDataBrowser (Qt v3+)

`virtual void del`();

This has been renamed `delOnCursor` in Python.

### QDataTable (Qt v3+)

`QDataTable` is fully implemented.

### QDataView (Qt v3+)

`QDataView` is fully implemented.

### QEditorFactory (Qt v3+)

`QEditorFactory` is fully implemented.

### QSql (Qt v3+)

`QSql` is fully implemented.

### QSqlCursor (Qt v3+)

`virtual int del`(bool invalidate = TRUE);

This has been renamed `delRecords` in Python.

`virtual int del`(const QString &filter, bool invalidate = TRUE);

This has been renamed `delRecords` in Python.

`bool exec`(const QString &query);

This has been renamed `execQuery` in Python.

### QSqlDatabase (Qt v3+)

`QSqlQuery exec`(const QString &query = QString::null);

This has been renamed `execStatement` in Python.

### QSqlDriver (Qt v3+)

`QSqlDriver` is fully implemented.

### QSqlEditorFactory (Qt v3+)

`QSqlEditorFactory` is fully implemented.

### QSqlError (Qt v3+)

`QSqlError` is fully implemented.

### QSqlField (Qt v3+)

`QSqlField` is fully implemented.

### QSqlFieldInfo (Qt v3+)

`QSqlFieldInfo` is fully implemented.

### QSqlForm (Qt v3+)

`QSqlForm` is fully implemented.

### QSqlIndex (Qt v3+)

`QSqlIndex` is fully implemented.

### QSqlPropertyMap (Qt v3+)

`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.

### QSqlQuery (Qt v3+)

`QMap<QString,QVariant> boundValues const`();

Not yet implemented. (Qt v3.2.0+)

`virtual bool exec`(const QString &query);

This has been renamed `execQuery` in Python.

`bool exec`();

This has been renamed `execQuery` in Python. (Qt v3.1+)

### QSqlRecord (Qt v3+)

`QSqlRecord` is fully implemented.

### QSqlRecordInfo (Qt v3+)

`QSqlRecordInfo` is implemented as a Python list of `QSqlFieldInfo` instances.

### QSqlResult (Qt v3+)

`QSqlResult` is fully implemented.

### QSqlSelectCursor (Qt v3.2.0+)

`int del`(bool invalidate = TRUE);

This has been renamed `delRecords` in Python.

`bool exec`(const QString &query);

This has been renamed `execQuery` in Python.

## `qttable` Module Reference

### QTable (Qt v2.2+)

`QTable` is fully implemented.

### QTableItem (Qt v2.2+)

`QTableItem` is fully implemented.

### QCheckTableItem (Qt v3+)

`QCheckTableItem` is fully implemented.

### QComboTableItem (Qt v3+)

`QComboTableItem` is fully implemented.

### QTableSelection (Qt v2.2+)

`QTableSelection` is fully implemented.

## `qtui` Module Reference

### QWidgetFactory (Qt v3+)

`QWidgetFactory` is fully implemented.

## `qtxml` Module Reference

### QDomImplementation (Qt v2.2+)

`QDomImplementation` is fully implemented.

### QDomNode (Qt v2.2+)

`QDomNode` is fully implemented, including the Python `==` and `!=` operators.

### QDomNodeList (Qt v2.2+)

`QDomNodeList` is fully implemented.

### QDomDocument (Qt v2.2+)

`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+)

### QDomDocumentFragment (Qt v2.2+)

`QDomDocumentFragment` is fully implemented.

### QDomDocumentType (Qt v2.2+)

`QDomDocumentType` is fully implemented.

### QDomNamedNodeMap (Qt v2.2+)

`QDomNamedNodeMap` is fully implemented.

### QDomCharacterData (Qt v2.2+)

`QDomCharacterData` is fully implemented.

### QDomAttr (Qt v2.2+)

`QDomAttr` is fully implemented.

### QDomElement (Qt v2.2+)

`QDomElement` is fully implemented.

### QDomText (Qt v2.2+)

`QDomText` is fully implemented.

### QDomComment (Qt v2.2+)

`QDomComment` is fully implemented.

### QDomCDATASection (Qt v2.2+)

`QDomCDATASection` is fully implemented.

### QDomNotation (Qt v2.2+)

`QDomNotation` is fully implemented.

### QDomEntity (Qt v2.2+)

`QDomEntity` is fully implemented.

### QDomEntityReference (Qt v2.2+)

`QDomEntityReference` is fully implemented.

### QDomProcessingInstruction (Qt v2.2+)

`QDomProcessingInstruction` is fully implemented.