Python Bindings for TQt (3.18.1) Phil Thompson This document describes a set of Python bindings for the TQt widget set. Contact the author at phil@riverbankcomputing.co.uk. Introduction PyTQt is a set of Python bindings for the TQt toolkit and available for all platforms supported by TQt, including Windows, Linux, UNIX, MacOS/X and embedded systems such as the Sharp Zaurus and the Compaq iPAQ. They have been tested against TQt versions 1.43 to 3.3.6, TQt Non-commercial, TQtopia 1.5.0, and Python versions 1.5 to 2.4.2. TQt/Embedded v3 is not supported. TQt v4 is supported by PyTQt v4. PyTQt is available under the GPL license for use with the GPL version of TQt, a a commercial license for use with the commercial version of TQt, a non-commercial license for use with the non-commercial version of TQt v2, and an educational license for use with the educational version of TQt. There is also an evaluation version of PyTQt for Windows. This must be used with the corresponding evaluation version of TQt. PyTQt 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 PyTQt. PyTQt for MacOS/X requires TQt 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 TQt's TQAxContainer module, part of TQt's ActiveTQt framework. qtcanvas contains the classes implemented in TQt's Canvas module. qtgl contains the classes implemented in TQt's OpenGL module. qtnetwork contains the classes implemented in TQt's Network module. qtpe contains the classes implemented in TQtopia (originally called the TQt Palmtop Environment). It is only supported with TQt/Embedded. qtsql contains the classes implemented in TQt's SQL module. qttable contains the classes implemented in TQt's Table module. qtui contains the classes implemented in TQt's tqui library. These allow GUIs to be created directly from TQt Designer's .ui files. qtxml contains the classes implemented in TQt's XML module. qtext contains useful third-party classes that are not part of TQt. At the moment it contains bindings for TQScintilla, the port to TQt of the Scintilla programmer's editor class. PyTQt also includes the pyuic and pylupdate utilities which correspond to the TQt uic and lupdate utilities. pyuic converts the GUI designs created with TQt 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 TQt Linguist. Changes The changes visible to the Python programmer in this release are as follows. This version requires SIP v4.4 (or later). Concatenating Python strings and TQStrings is now supported. TQString now supports the * and *= operators that behave as they do for Python strings. TQString is more interoperable with Python string and unicode objects. For example they can be passed as arguments to open() and to most (but not all) string methods. TQPopupMenu (and sub-classes) instances now transfer ownership of the menu to Python in the call to exec_loop(). This means the menu's resources are all released when the Python wrapper is garbage collected without needing to call TQObject.deleteLater(). TQObject.sender() now handles Python signals. The missing MacintoshVersion enum has been added. PYQT_BUILD has been removed. The convention for converting between a C/C++ null pointer and Python's None object has now been universally applied. In previous versions a null pointer to, for example, a TQt list container would often be converted to an empty list rather than None. Other PyTQt Goodies Using TQt Designer TQt Designer is a GPL'ed GUI design editor provided by Trolltech as part of TQt. It generates an XML description of a GUI design. TQt includes uic which generates C++ code from that XML. PyTQt 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 TQt 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 TQt Designer to implement slots. In TQt 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: TQMessageBox.critical(self, "Event", "browse pushbutton was clicked!") } Here is the resulting code when pyuic is run. class DebMainWindowFrm(TQMainWindow): ...stuff... def browsePushButtonClicked(self): if self.debugging: TQMessageBox.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 TQt Linguist TQt 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, PyTQt includes the pylupdate program. This generates the same .ts language source files from your PyTQt source files. Deploying Commercial PyTQt Applications When deploying commercial PyTQt applications it is necessary to discourage users from accessing the underlying PyTQt 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 TQt and PyTQt 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 PyTQt 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 PyTQt with support for the VendorID package, pass the -i command line flag to configure.py. <Literal>pyqtconfig</Literal> and Build System Support The SIP build system (ie. the sipconfig module) is described in the SIP documentation. PyTQt includes the pyqtconfig module that can be used by configuration scripts of other bindings that are built on top of PyTQt. The pyqtconfig module contains the following classes: Configuration(sipconfig.Configuration) This class encapsulates additional configuration values, specific to PyTQt, 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_config_args The command line passed to configure.py when PyTQt was configured. pyqt_mod_dir The name of the directory containing the PyTQt modules. pyqt_modules A string containing the names of the PyTQt 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 PyTQt modules is installed. A sub-directory exists with the same name as the module. pyqt_version The PyTQt version as a 3 part hexadecimal number (eg. v3.10 is represented as 0x030a00). pyqt_version_str The PyTQt version as a string. For development snapshots it will start with snapshot-. TQtModuleMakefile(sipconfig.SIPModuleMakefile) The Makefile class for modules that import the qt module. finalise(self) This is a reimplementation of sipconfig.Makefile.finalise(). TQtAxContainerModuleMakefile(TQtModuleMakefile) The Makefile class for modules that import the qtaxcontainer module. finalise(self) This is a reimplementation of sipconfig.Makefile.finalise(). TQtCanvasModuleMakefile(TQtModuleMakefile) The Makefile class for modules that import the qtcanvas module. finalise(self) This is a reimplementation of sipconfig.Makefile.finalise(). TQtExtModuleMakefile(TQtModuleMakefile) The Makefile class for modules that import the qtext module. finalise(self) This is a reimplementation of sipconfig.Makefile.finalise(). TQtGLModuleMakefile(TQtModuleMakefile) The Makefile class for modules that import the qtgl module. finalise(self) This is a reimplementation of sipconfig.Makefile.finalise(). TQtNetworkModuleMakefile(TQtModuleMakefile) The Makefile class for modules that import the qtnetwork module. finalise(self) This is a reimplementation of sipconfig.Makefile.finalise(). TQtTableModuleMakefile(TQtModuleMakefile) The Makefile class for modules that import the qttable module. finalise(self) This is a reimplementation of sipconfig.Makefile.finalise(). TQtSQLModuleMakefile(TQtTableModuleMakefile) The Makefile class for modules that import the qtsql module. finalise(self) This is a reimplementation of sipconfig.Makefile.finalise(). TQtUIModuleMakefile(TQtModuleMakefile) The Makefile class for modules that import the qtui module. finalise(self) This is a reimplementation of sipconfig.Makefile.finalise(). TQtXMLModuleMakefile(TQtModuleMakefile) 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 super and Wrapped Classes Internally PyTQt 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 PyTQt. In most circumstances this technique is transparent to an application. The exception is when super is used with a PyTQt 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 PyTQt. Python Strings, TQt Strings and Unicode Unicode support was added to TQt in v2.0 and to Python in v1.6. In TQt, Unicode support is implemented using the TQString class. It is important to understand that TQStrings, Python string objects and Python Unicode objects are all different but conversions between them are automatic in almost all cases and easy to achieve manually when needed. Whenever PyTQt expects a TQString as a function argument, a Python string object or a Python Unicode object can be provided instead, and PyTQt will do the necessary conversion automatically. You may also manually convert Python string and Unicode objects to TQStrings by using the TQString constructor as demonstrated in the following code fragment. qs1 = TQString('Converted Python string object') qs2 = TQString(u'Converted Python Unicode object') In order to convert a TQString to a Python string object use the Python str() function. Applying str() to a null TQString and an empty TQString both result in an empty Python string object. In order to convert a TQString to a Python Unicode object use the Python unicode() function. Applying unicode() to a null TQString and an empty TQString 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. <Literal>None</Literal> and <Literal>NULL</Literal> 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++ <Literal>void *</Literal> Data Types PyTQt 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 PyTQt implements the full set of TQt'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 PyTQt does not impose any additional restrictions. (Read the relevant part of the TQt documentation to understand the restrictions imposed by the TQt 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 TQt API then the very first import of one of the PyTQt modules must be done from the main thread. If you use the Python API then all calls to PyTQt (including any imports) must be done from one thread only. Therefore, if you want to make calls to PyTQt from several threads then you must use the TQt API. If you want to use both APIs in the same application then all calls to PyTQt must be done from threads created using the TQt API. The above comments actually apply to any SIP generated module, not just PyTQt. 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 = new TQColor(); c = new TQColor(); In the corresponding Python fragment, the first colour is destroyed when the second is assigned to c: c = TQColor() c = TQColor() 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 = TQColor() self.c2 = TQColor() Sometimes a TQt 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 TQObject (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 TQLabel is not destroyed when the second is assigned to l because the parent TQWidget still has a reference to it. p = TQWidget() l = TQLabel('First label',p) l = TQLabel('Second label',p) C++ Variables Access to C++ variables is supported. They are accessed as Python instance variables. For example: tab = TQTab() tab.label = "First Tab" tab.r = TQRect(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 TQt class. i18n Support TQt implements i18n support through the TQt Linguist application, the TQTranslator class, and the TQApplication::translate(), TQObject::tr() and TQObject::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, TQApplication::translate() allows to context to be explicitly stated. Unfortunately, because of the way TQt implents tr() (and trUtf8()) it is not possible for PyTQt to exactly reproduce its behavour. The PyTQt 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 PyTQt, but is hardcoded in TQt. In other words, the context of a translation may change depending on an instance's class hierarchy. class A(TQObject): def __init__(self): TQObject.__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 PyTQt behaviour is unsatisfactory and may be changed in the future. It is recommended that TQApplication.translate() be used in preference to tr() (and trUtf8()). This is guaranteed to work with current and future versions of PyTQt and makes it much easier to share message files between Python and C++ code. Below is the alternative implementation of A that uses TQApplication.translate(). class A(TQObject): def __init__(self): TQObject.__init__(self) def hello(self): return tqApp.translate("A","Hello") Note that the code generated by pyuic uses TQApplication.translate(). Signal and Slot Support A signal may be either a TQt signal (specified using SIGNAL()) or a Python signal (specified using PYSIGNAL()). A slot can be either a Python callable object, a TQt signal (specified using SIGNAL()), a Python signal (specified using PYSIGNAL()), or a TQt slot (specified using SLOT()). You connect signals to slots (and other signals) as you would from C++. For example: TQObject.connect(a,SIGNAL("TQtSig()"),pyFunction) TQObject.connect(a,SIGNAL("TQtSig()"),pyClass.pyMethod) TQObject.connect(a,SIGNAL("TQtSig()"),PYSIGNAL("PySig")) TQObject.connect(a,SIGNAL("TQtSig()"),SLOT("TQtSlot()")) TQObject.connect(a,PYSIGNAL("PySig"),pyFunction) TQObject.connect(a,PYSIGNAL("PySig"),pyClass.pyMethod) TQObject.connect(a,PYSIGNAL("PySig"),SIGNAL("TQtSig()")) TQObject.connect(a,PYSIGNAL("PySig"),SLOT("TQtSlot()")) When a slot is a Python method that corresponds to a TQt slot then a signal can be connected to either the Python method or the TQt slot. The following connections achieve the same effect. sbar = TQScrollBar() lcd = TQLCDNumber() TQObject.connect(sbar,SIGNAL("valueChanged(int)"),lcd.display) TQObject.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 TQObject class can emit a signal using the emit method. This takes two arguments. The first is the Python or TQt 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. TQt allows a signal to be connected to a slot that requires fewer arguments than the signal passes. The extra arguments are tquietly 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 TQObject::connect() is called from Python as TQObject.connect() or self.connect() if called from a sub-class of TQObject. 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: TQt.SolidPattern TQWidget.TabFocus TQFrame.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. <Literal>qt</Literal> Module Reference TQt Constants All constant values defined by TQt have equivalent constants defined to Python. TQt (TQt v2+) TQt is fully implemented. TQAccel TQAccel is fully implemented. TQAction (TQt v2.2+) TQAction is fully implemented. TQActionGroup (TQt v2.2+) TQActionGroup is fully implemented. TQApplication TQApplication int &argc char **argv This takes one parameter which is a list of argument strings. Arguments used by TQt are removed from the list. TQApplication int &argc char **argv bool GUIenabled This takes two parameters, the first of which is a list of argument strings. Arguments used by TQt are removed from the list. TQApplication int &argc char **argv Type type This takes two parameters, the first of which is a list of argument strings. Arguments used by TQt are removed from the list. (TQt v2.2+) int exec This has been renamed to exec_loop in Python. TQAssistantClient (TQt v3.1+) TQAssistantClient is fully implemented. TQBitmap TQBitmap is fully implemented. TQBrush TQBrush is fully implemented, including the Python == and != operators. TQButton TQButton is fully implemented. TQButtonGroup TQButtonGroup is fully implemented. TQByteArray A Python string can be used whenever a TQByteArray can be used. A TQByteArray can be converted to a Python string using the Python str() function. TQByteArray &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. TQByteArray &setRawData const char *data uintsize Not implemented. TQCDEStyle (TQt v2+) TQCDEStyle is fully implemented. TQCheckBox TQCheckBox is fully implemented. TQClipboard void *data const const char *format Not yet implemented (TQt v1.x). void setData const char *format void * Not yet implemented (TQt v1.x). TQColor 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. TQColorDialog (TQt v2+) static TQRgb getRgba TQRgb initial bool *ok TQWidget *parent = 0 const char *name = 0 This takes the initial, parent and name parameters and returns a tuple containing the TQRgb result and the ok value. TQColorGroup TQColorGroup is fully implemented. TQComboBox TQComboBox is fully implemented. TQCommonStyle (TQt v2+) virtual void getButtonShift int &x int &y This takes no parameters and returns a tuple of the x and y values. (TQt v2) virtual void tabbarMetrics const TQTabBar *t int &hframe int &vframe int &overlap This takes only the t parameter and returns a tuple of the hframe, vframe and overlap values. (TQt v2) TQCString (TQt v2+) A Python string can be used whenever a TQCString can be used. A TQCString can be converted to a Python string using the Python str() function. TQCString &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. TQCursor TQCursor is fully implemented. TQDataStream TQDataStream &readBytes const char *&s uint &l This takes no parameters. The TQDataStream result and the data read are returned as a tuple. TQDataStream &readRawBytes const char *s uint l This takes only the l parameter. The TQDataStream result and the data read are returned as a tuple. TQDataStream &writeBytes const char *s uint len len is derived from s and not passed as a parameter. TQDataStream &writeRawBytes const char *s uint len len is derived from s and not passed as a parameter. TQDate 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. (TQt v3.1+) TQDateTime TQDateTime is fully implemented, including the Python ==, !=, <, <=, >, >= and __nonzero__ operators. TQTime TQTime is fully implemented, including the Python ==, !=, <, <=, >, >= and __nonzero__ operators. TQDateEdit (TQt v3+) TQDateEdit is fully implemented. TQTimeEdit (TQt v3+) TQTimeEdit is fully implemented. TQDateTimeEdit (TQt v3+) TQDateTimeEdit is fully implemented. TQDesktopWidget (TQt v3+) TQDesktopWidget is fully implemented. TQDial (TQt v2.2+) TQDial is fully implemented. TQDialog int exec 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 TQObject.deleteLater() or other techniques. TQDir TQDir is fully implemented, including the Python len, [] (for reading slices and individual elements), ==, != and in operators TQFileInfoList This class isn't implemented. Whenever a TQFileInfoList is the return type of a function or the type of an argument, a Python list of TQFileInfo instances is used instead. TQDockArea (TQt v3+) bool hasDockWindow const TQDockWindow *w int *index = 0 This takes the w parameter and returns the index of the TQDockWIndow or -1 if the TQDockArea does not contain the TQDockWindow. TQDockWindow (TQt v3+) TQDockWindow is fully implemented. TQColorDrag (TQt v2.1+) TQColorDrag is fully implemented. TQDragObject TQDragObject is fully implemented. TQImageDrag TQImageDrag is fully implemented. TQStoredDrag TQStoredDrag is fully implemented. TQTextDrag TQTextDrag is fully implemented. TQUriDrag (TQt v2+) TQUriDrag is fully implemented. TQUrlDrag (TQt v1.x) TQUrlDrag is fully implemented. TQDropSite TQDropSite is fully implemented. TQErrorMessage (TQt v3+) TQErrorMessage is fully implemented. TQEvent TQEvent is fully implemented. Instances of TQEvents are automatically converted to the correct sub-class. TQChildEvent TQChildEvent is fully implemented. TQCloseEvent TQCloseEvent is fully implemented. TQIconDragEvent (TQt v3.3+) TQIconDragEvent is fully implemented. TQContextMenuEvent (TQt v3+) TQContextMenuEvent is fully implemented. TQCustomEvent TQCustomEvent is fully implemented. Any Python object can be passed as the event data and its reference count is increased. TQDragEnterEvent TQDragEnterEvent is fully implemented. TQDragLeaveEvent TQDragLeaveEvent is fully implemented. TQDragMoveEvent TQDragMoveEvent is fully implemented. TQDropEvent TQDropEvent is fully implemented. TQFocusEvent TQFocusEvent is fully implemented. TQHideEvent TQHideEvent is fully implemented. TQIMComposeEvent (TQt v3.1+) TQIMComposeEvent is fully implemented. TQIMEvent (TQt v3+) TQIMEvent is fully implemented. TQKeyEvent TQKeyEvent is fully implemented. TQMouseEvent TQMouseEvent is fully implemented. TQMoveEvent TQMoveEvent is fully implemented. TQPaintEvent TQPaintEvent is fully implemented. TQResizeEvent TQResizeEvent is fully implemented. TQShowEvent TQShowEvent is fully implemented. TQTabletEvent (TQt v3+) TQTabletEvent is fully implemented. TQTimerEvent TQTimerEvent is fully implemented. TQWheelEvent (TQt v2+) TQWheelEvent is fully implemented. TQEventLoop (TQt v3.1+) virtual int exec This has been renamed to exec_loop in Python. TQFile bool open int m FILE *f Not implemented. TQ_LONG readBlock char *data TQ_ULONG len This takes a single len parameter. The data is returned if there was no error, otherwise None is returned. TQ_LONG readLine char *data TQ_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. (TQt v2+) static void setEncodingFunction EncoderFn f Not yet implemented. (TQt v2+) TQ_LONG writeBlock const char *data TQ_ULONG len len is derived from data and not passed as a parameter. TQFileDialog TQFileDialog is fully implemented. TQFileIconProvider TQFileIconProvider is fully implemented. TQFilePreview TQFilePreview is fully implemented. However it cannot be used from Python in the same way as it is used from C++ because PyTQt 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(TQFilePreview): pass class Preview(TQLabel): def __init__(self, parent=None): TQLabel.__init__(self, parent) self.preview = FilePreview() self.preview.previewUrl = self.previewUrl Note that TQFilePreview cannot be instantiated directly because it is abstract. Thanks to Hans-Peter Jansen for this trick. TQFileInfo TQFileInfo is fully implemented. TQFont TQFont is fully implemented, including the Python == and != operators. TQFontDatabase (TQt v2.1+) TQFontDatabase is fully implemented. TQFontDialog (TQt v2+) static TQFont getFont bool *ok const TQFont &def TQWidget *parent = 0 const char *name = 0 This takes the def, parent and name parameters and returns a tuple containing the TQFont result and the ok value. static TQFont getFont bool *ok TQWidget *parent = 0 const char *name = 0 This takes the parent and name parameters and returns a tuple containing the TQFont result and the ok value. TQFontInfo TQFontInfo is fully implemented. TQFontMetrics TQRect boundingRect int x int y int w int h int flags const TQString &str int len = -1 int tabstops = 0 int *tabarray = 0 The tabarray parameter is a Python list of integers. TQSize size int flags const TQString &str int len = -1 int tabstops = 0 int *tabarray = 0 The tabarray parameter is a Python list of integers. TQFrame TQFrame is fully implemented. TQGManager (TQt v1.x) TQGManager is fully implemented. TQChain (TQt v1.x) TQChain is implemented as an opaque class. TQGrid (TQt v2+) TQGrid is fully implemented. TQGridView (TQt v3+) TQGridView is fully implemented. TQGroupBox TQGroupBox is fully implemented. TQHBox (TQt v2+) TQHBox is fully implemented. TQHButtonGroup (TQt v2+) TQHButtonGroup is fully implemented. TQHeader TQHeader is fully implemented. TQHGroupBox (TQt v2+) TQHGroupBox is fully implemented. TQIconSet TQIconSet is fully implemented. TQIconFactory (TQt v3.1+) TQIconFactory is fully implemented. TQIconView (TQt v2.1+) TQIconViewItem *makeRowLayout TQIconViewItem *begin int &y Not yet implemented. TQIconViewItem (TQt v2.1+) TQIconViewItem is fully implemented. TQIconDrag (TQt v2.1+) TQIconDrag is fully implemented. TQIconDragItem (TQt v2.1+) TQIconDragItem is fully implemented. TQImage The Python == and != operators are supported. TQImage const char *xpm[] This takes a list of strings as its parameter. TQImage uchar *data int w int h int depth TQRgb *colorTable int numColors Endian bitOrder The colorTable parameter is a list of TQRgb instances or None. (TQt v2.1+) uchar *bits The return value is a sip.voidptr object which is only useful if passed to another Python module. TQRgb *colorTable The return value is a sip.voidptr object which is only useful if passed to another Python module. TQImage convertDepthWithPalette int TQRgb *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. TQImageIO static void defineIOHandler const char *format const char *header const char *flags image_io_handler read_image image_io_handler write_image Not implemented. TQImageTextKeyLang TQImageTextKeyLang is fully implemented. TQInputDialog (TQt v2.1+) static TQString getText const TQString &caption const TQString &label const TQString &text = TQString::null bool *ok = 0 TQWidget *parent = 0 const char *name = 0 The ok is not passed and the returned value is a tuple of the TQString result and the ok flag. (TQt v2.1 - v2.3.1) static TQString getText const TQString &caption const TQString &label TQLineEdit::EchoModeecho const TQString &text = TQString::null bool *ok = 0 TQWidget *parent = 0 const char *name = 0 The ok is not passed and the returned value is a tuple of the TQString result and the ok flag. (TQt v2.2 - v2.3.1) static TQString getText const TQString &caption const TQString &label TQLineEdit::EchoModeecho = TQLineEdit::Normal const TQString &text = TQString::null bool *ok = 0 TQWidget *parent = 0 const char *name = 0 The ok is not passed and the returned value is a tuple of the TQString result and the ok flag. (TQt v3+) static int getInteger const TQString &caption const TQString &label int num = 0 int from = -2147483647 int to = 2147483647 int step = 1 bool *ok = 0 TQWidget *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 TQString &caption const TQString &label double num = 0 double from = -2147483647 double to = 2147483647 int step = 1 bool *ok = 0 TQWidget *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 TQString getItem const TQString &caption const TQString &label const TQStringList &list int current = 0 bool editable = TRUE bool *ok = 0 TQWidget *parent = 0 const char *name = 0 The ok is not passed and the returned value is a tuple of the TQString result and the ok flag. TQInterlaceStyle (TQt v2.3.1+) void scrollBarMetrics const TQTabBar *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. TQIODevice TQIODevice is fully implemented. TQKeySequence (TQt v3+) TQKeySequence is fully implemented including the operators ==, !=, TQString() and int(). A TQString instance or a Python integer may be used whenever a TQKeySequence can be used. TQLabel TQLabel is fully implemented. TQLayout TQLayout is fully implemented. TQBoxLayout TQBoxLayout is fully implemented. TQGLayoutIterator (TQt v2+) TQGLayoutIterator is fully implemented. TQGridLayout bool findWidget TQWidget *w int *row int *col This takes the w parameter and returns a tuple containing the bool result, row and col. (TQt v2+) TQHBoxLayout TQHBoxLayout is fully implemented. TQLayoutItem (TQt v2+) TQLayoutItem is fully implemented. TQLayoutIterator (TQt v2+) TQLayoutItem *next This is a wrapper around the TQLayoutIterator ++ operator. TQSpacerItem (TQt v2+) TQSpacerItem is fully implemented. TQVBoxLayout TQVBoxLayout is fully implemented. TQWidgetItem (TQt v2+) TQWidgetItem is fully implemented. TQLCDNumber TQLCDNumber is fully implemented. TQLibrary (TQt v3+) TQLibrary is fully implemented. TQLineEdit int characterAt int xpos TQChar *chr This takes only the xpos parameter and returns the int result and the chr value as a tuple. (TQt v3+) void del This has been renamed delChar in Python. (TQt 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. (TQt v3+) TQList<type> (TQt v2) Types based on the TQList template are automatically converted to and from Python lists of the type. TQListBox bool itemYPos int index int *yPos This takes the index parameter and returns a tuple containing the bool result and yPos. (TQt v1.x) TQListBoxItem TQListBoxItem is fully implemented. TQListBoxPixmap TQListBoxPixmap is fully implemented. TQListBoxText TQListBoxText is fully implemented. TQListView TQListView is fully implemented. Note that to remove a child TQListViewItem you must first call takeItem() and then del(). TQListViewItem TQListViewItem is fully implemented. Note that to remove a child TQListViewItem you must first call takeItem() and then del(). TQCheckListItem TQCheckListItem is fully implemented. TQListViewItemIterator (TQt v2+) TQListViewItemIterator is fully implemented. TQLocale (TQt 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. TQ_LONG toLong bool *ok = 0 This returns a tuple of the long result and the ok value. TQ_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. TQMainWindow TQTextStream &operator<< TQTextStream & const TQMainWindow & This operator is fully implemented. (TQt v3+) TQTextStream &operator>> TQTextStream & TQMainWindow & This operator is fully implemented. (TQt v3+) bool getLocation TQToolBar *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. (TQt v2.1.0+) TQList<TQToolBar> toolBars ToolBarDock dock This returns a list of TQToolBar instances. (TQt v2.1.0+) TQMemArray<type> (TQt v3+) Types based on the TQMemArray template are automatically converted to and from Python lists of the type. TQMenuBar TQMenuBar is fully implemented. TQMenuData TQMenuItem *findItem int id TQMenuData **parent Not implemented. TQCustomMenuItem (TQt v2.1+) TQCustomMenuItem is fully implemented. TQMenuItem TQMenuItem is an internal TQt class. TQMessageBox TQMessageBox is fully implemented. TQMetaObject int numClassInfo const bool super = FALSE Not implemented. const TQClassInfo *classInfo const bool super = FALSE Not implemented. TQMetaProperty TQMetaProperty is fully implemented. TQMimeSource (TQt v2+) TQMimeSource is fully implemented. TQMimeSourceFactory (TQt v2+) TQMimeSourceFactory is fully implemented. TQWindowsMime (TQt v3+) TQWindowsMime is fully implemented. TQMotifPlusStyle (TQt v2.2+) void getButtonShift int &x int &y This takes no parameters and returns a tuple of the x and y values. (TQt v2) void scrollBarMetrics const TQScrollBar *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. (TQt v2) TQMotifStyle (TQt v2+) void scrollBarMetrics const TQTabBar *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. (TQt v2) void tabbarMetrics const TQTabBar *t int &hframe int &vframe int &overlap This takes only the t parameter and returns a tuple of the hframe, vframe and overlap values. (TQt v2) TQMovie TQMovie TQDataSource *src int bufsize = 1024 Not implemented. void pushData const uchar *data int length length is derived from data and not passed as a parameter. (TQt v2.2.0+) TQMultiLineEdit void cursorPosition const int *line int *col This takes no parameters and returns a tuple of the line and col values. (TQt v1.x, TQt v2.x) virtual void del This has been renamed delChar in Python. (TQt v1.x, TQt v2.x) void getCursorPosition const int *line int *col This takes no parameters and returns a tuple of the line and col values. (TQt v1.x, TQt 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. TQMutex (TQt v2.2+) TQMutex is fully implemented. TQMutexLocker (TQt v3.1+) TQMutexLocker is fully implemented. TQNetworkOperation (TQt v2.1+) TQNetworkOperation is fully implemented. TQNetworkProtocol (TQt v2.1+) TQNetworkProtocol is fully implemented. TQNetworkProtocolFactoryBase (TQt v2.1+) TQNetworkProtocolFactoryBase is fully implemented. TQObject bool disconnect const TQObject *receiver const char *member = 0 Not yet implemented. bool disconnect const char *signal = 0 const TQObject *receiver = 0 const char *member = 0 Not yet implemented. static bool disconnect const TQObject *sender const char *signal const TQObject *receiver const char *member At the moment PyTQt does not support the full behaviour of the corresponding TQt method. In particular, specifying None (ie. 0 in C++) for the signal and receiver parameters is not yet supported. TQObjectCleanupHandler (TQt v3+) TQObjectCleanupHandler is fully implemented. TQObjectList This class isn't implemented. Whenever a TQObjectList is the return type of a function or the type of an argument, a Python list of TQObject instances is used instead. TQPaintDeviceMetrics TQPaintDeviceMetrics is fully implemented. TQPaintDevice virtual bool cmd int TQPainter * TQPDevCmdParam * Not implemented. TQPainter TQRect 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. TQRect boundingRect const TQRect& 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 TQRect *br = 0 char **intern = 0 The intern parameter is not supported. void drawText const TQRect& int flags const char *str int len = -1 TQRect *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. TQPalette TQPalette is fully implemented, including the Python == and != operators. TQPixmap TQPixmap 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. TQPixmapCache (TQt v3+) TQPixmapCache is fully implemented. TQPair<type,type> (TQt v3+) Types based on the TQPair template are automatically converted to and from Python tuples of two elements. TQPen TQPen is fully implemented, including the Python == and != operators. TQPicture const char *data Not implemented. void setData const char *data uint size size is derived from data and not passed as a parameter. TQPlatinumStyle (TQt v2+) void scrollBarMetrics const TQTabBar *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. (TQt v2) TQPoint The Python +, +=, -, -=, unary -, *, *=, /, /=, ==, != and __nonzero__ operators are supported. TQCOORD &rx Not implemented. TQCOORD &ry Not implemented. TQPointArray TQPointArray int nPoints const TQCOORD *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 TQCOORD *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 TQCOORD *points This takes a single parameter which is a list of points. bool setPoints int nPoints int firstx int firsty ... Not implemented. TQPopupMenu int exec This has been renamed exec_loop in Python. This method also causes ownership of the underlying C++ menu to be transfered to Python. This means that the C++ menu will be deleted when the Python wrapper is garbage collected. Although this is a little inconsistent, it ensures that the menu is deleted without having to explicity code it using TQObject.deleteLater() or other techniques. int exec const TQPoint &pos int indexAtPoint = 0 This has been renamed exec_loop in Python. This method also causes ownership of the underlying C++ menu to be transfered to Python. This means that the C++ menu will be deleted when the Python wrapper is garbage collected. Although this is a little inconsistent, it ensures that the menu is deleted without having to explicity code it using TQObject.deleteLater() or other techniques. TQPrintDialog (X11) TQPrintDialog is fully implemented. TQPrinter TQPrinter is fully implemented. TQProcess (TQt v3+) TQProcess is fully implemented. TQProgressBar TQProgressBar is fully implemented. TQProgressDialog TQProgressDialog is fully implemented. value. TQPtrList<type> (TQt v2+) Types based on the TQPtrList template are automatically converted to and from Python lists of the type. TQPushButton TQPushButton is fully implemented. TQRadioButton TQRadioButton is fully implemented. TQRangeControl TQRangeControl is fully implemented. TQRect 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. TQCOORD &rBottom Not implemented. (TQt v2+) TQCOORD &rLeft Not implemented. (TQt v2+) TQCOORD &rRight Not implemented. (TQt v2+) TQCOORD &rTop Not implemented. (TQt v2+) TQRegExp 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. (TQt v1.x) int match const TQString &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. (TQt v2+) TQRegion The Python |, |=, +, +=, &, &=, -, -=, ^, ^=, ==, !=, in and __nonzero__ operators are supported. TQArray<TQRect> rects Not implemented. void setRects TQRect *rects int num Not yet implemented. (TQt v2.2+) TQScrollBar TQScrollBar is fully implemented. TQScrollView 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. (TQt 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. (TQt v2+) TQSemaphore (TQt v2.2+) TQSemaphore is fully implemented. The += and -= operators have also been implemented, but require Python v2.0 or later. TQSemiModal (TQt v1, v2) TQSemiModal is fully implemented. TQSessionManager (TQt v2+) TQSessionManager is fully implemented. TQSettings (TQt v3+) bool readBoolEntry const TQString &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 TQString &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. TQString readEntry const TQString &key const TQString &def = TQString::null bool *ok = 0 The ok is not passed and the returned value is a tuple of the TQString result and the ok flag. TQStringList readListEntry const TQString &key bool *ok = 0 The ok is not passed and the returned value is a tuple of the TQStringList result and the ok flag. TQStringList readListEntry const TQString &key const TQChar &separator bool *ok = 0 The ok is not passed and the returned value is a tuple of the TQStringList result and the ok flag. int readNumEntry const TQString &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 TQString &key bool value Not implemented. TQSGIStyle (TQt v2.2+) void scrollBarMetrics const TQScrollBar *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. (TQt v2) TQSignalMapper TQSignalMapper is fully implemented. TQSimpleRichText (TQt v2+) TQSimpleRichText is fully implemented. TQSize The Python +, +=, -, -=, *, *=, /, /=, ==, != and __nonzero__ operators are supported. TQCOORD &rheight Not implemented. TQCOORD &rwidth Not implemented. TQSizeGrip (TQt v2+) TQSizeGrip is fully implemented. TQSizePolicy (TQt v2+) TQSizePolicy is fully implemented. TQSlider TQSlider is fully implemented. TQSocketNotifier TQSocketNotifier is fully implemented. TQSound (TQt v2.2+) TQSound is fully implemented. TQSpinBox virtual int mapTextToValue bool *ok This returns a tuple of the int result and the modified ok value. TQSplashScreen (TQt v3.2.0+) TQSplashScreen is fully implemented. TQSplitter void getRange int id int *min int *max This takes the id parameter and returns the min and max values as a tuple. (TQt v2+) TQStatusBar TQStatusBar is fully implemented. TQChar (TQt v2+) uchar &cell const Not implemented. uchar &row const Not implemented. TQString A Python string object (or Unicode object) can be used whenever a TQString can be used. A TQString 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. TQCharRef at uint i Not yet implemented. (TQt v2+) TQChar constref const uint i Not yet implemented. (TQt v2+) TQChar &ref uint i Not yet implemented. (TQt v2+) TQString &setUnicodeCodes const ushort *unicode_as_shorts uint len Not yet implemented. (TQt v2.1+) TQString &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. TQStringList (TQt 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 TQString &x This does not return a value. Iterator prepend const TQString &x This does not return a value. TQStrList This class isn't implemented. Whenever a TQStrList is the return type of a function or the type of an argument, a Python list of strings is used instead. TQStyle (TQt v2+) virtual void getButtonShift int &x int &y This takes no parameters and returns a tuple of the x and y values. (TQt v2) virtual void scrollBarMetrics const TQScrollBar *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. (TQt v2) virtual void tabbarMetrics const TQTabBar *t int &hframe int &vframe int &overlap This takes only the t parameter and returns a tuple of the hframe, vframe and overlap values. (TQt v2) TQStyleOption (TQt v3+) TQStyleOption is fully implemented. TQStyleSheet (TQt v2+) TQStyleSheet is fully implemented. TQStyleSheetItem (TQt v2+) TQStyleSheetItem is fully implemented. TQSyntaxHighlighter (TQt v3.1+) TQSyntaxHighlighter is fully implemented. TQTab TQTab is fully implemented. TQTabBar TQList<TQTab> tabList This returns a list of TQTab instances. TQTabDialog TQTabDialog is fully implemented. TQTableView (TQt 1.x, TQt 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. TQTabWidget (TQt v2+) TQTabWidget is fully implemented. TQTextBrowser (TQt v2+) TQTextBrowser is fully implemented. TQTextCodec (TQt v2+) virtual TQCString fromUnicode const TQString &uc int &lenInOut The returned value is a tuple of the TQCString result and the updated lenInOut. TQTextDecoder (TQt v2+) TQTextDecoder is fully implemented. TQTextEncoder (TQt v2+) virtual TQCString fromUnicode = 0 const TQString &uc int &lenInOut The returned value is a tuple of the TQCString result and the updated lenInOut. TQTextEdit (TQt v3+) int charAt const TQPoint &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 TQString &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. TQTextStream TQTextStream FILE *fp int mode Not implemented. TQTextStream &readRawBytes char *buf uint len Not yet implemented. TQTextStream &writeRawBytes const char *buf uint len Not yet implemented. TQTextIStream (TQt v2+) TQTextIStream FILE *fp int mode Not implemented. TQTextOStream (TQt v2+) TQTextOStream FILE *fp int mode Not implemented. TQTextView (TQt v2+) TQTextView is fully implemented. TQThread (TQt v2.2+) TQThread is fully implemented. TQTimer TQTimer is fully implemented. TQToolBar TQToolBar is fully implemented. TQToolBox (TQt v3.2.0+) TQToolBox is fully implemented. TQToolButton TQToolButton is fully implemented. TQToolTip TQToolTip is fully implemented. TQToolTipGroup TQToolTipGroup is fully implemented. TQTranslator (TQt v2+) TQTranslator is fully implemented. TQTranslatorMessage (TQt v2.2+) TQTranslatorMessage is fully implemented. TQUrl (TQt v2.1+) TQUrl is fully implemented, including the TQString(), == and != operators. TQUrlInfo (TQt v2.1+) TQUrlInfo is fully implemented. TQUrlOperator (TQt v2.1+) virtual bool isDir bool *ok This returns a tuple of the bool result and the ok value. TQUuid (TQt v3.0+) TQUuid is fully implemented. TQValidator virtual State validate TQString& input int& pos The returned value is a tuple of the State result and the updated pos. TQDoubleValidator State validate TQString& input int& pos The returned value is a tuple of the State result and the updated pos. TQIntValidator State validate TQString& input int& pos The returned value is a tuple of the State result and the updated pos. TQRegExpValidator (TQt v3+) virtual State validate TQString& input int& pos The returned value is a tuple of the State result and the updated pos. TQValueList<type> (TQt v2+) Types based on the TQValueList template are automatically converted to and from Python lists of the type. TQVariant (TQt v2.1+) TQVariant const char *val Not implemented. TQVariant const TQBitArray &val Not yet implemented. (TQt v3+) TQVariant const TQValueList<TQVariant> &val Not yet implemented. TQVariant const TQMap<TQString,TQVariant> &val Not yet implemented. TQBitArray &asBitArray Not yet implemented. (TQt v3+) bool &asBool Not implemented. double &asDouble Not implemented. int &asInt Not implemented. TQValueList<TQVariant> &asList Not implemented. TQMap<TQString,TQVariant> &asMap Not implemented. uint &asUInt Not implemented. TQValueListConstIterator<TQVariant>listBegin const Not implemented. TQValueListConstIterator<TQVariant>listEnd const Not implemented. TQMapConstIterator<TQString,TQVariant>mapBegin const Not implemented. TQMapConstIterator<TQString,TQVariant>mapEnd const Not implemented. TQMapConstIterator<TQString,TQVariant>mapFind const const TQString &key Not implemented. TQValueListConstIterator<TQString>stringListBegin const Not implemented. TQValueListConstIterator<TQString>stringListEnd const Not implemented. const TQBitArray toBitArray const Not yet implemented. (TQt v3+) const TQValueList<TQVariant>toList const Not yet implemented. const TQMap<TQString,TQVariant>toMap const Not yet implemented. TQVBox (TQt v2+) TQVBox is fully implemented. TQVButtonGroup (TQt v2+) TQVButtonGroup is fully implemented. TQVGroupBox (TQt v2+) TQVGroupBox is fully implemented. TQWaitCondition (TQt v2.2+) TQWaitCondition is fully implemented. TQWhatsThis TQWhatsThis is fully implemented. TQWidget TQWExtra *extraData Not implemented. TQFocusData *focusData Not implemented. void lower This has been renamed to lowerW in Python. void raise This has been renamed to raiseW in Python. TQWidgetList This class isn't implemented. Whenever a TQWidgetList is the return type of a function or the type of an argument, a Python list of instances is used instead. TQWidgetStack TQWidgetStack is fully implemented. TQWindow TQWindow is fully implemented (TQt v1.x). TQWindowsStyle (TQt v2+) void getButtonShift int &x int &y This takes no parameters and returns a tuple of the x and y values. (TQt v2) void scrollBarMetrics const TQTabBar *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. (TQt v2) void tabbarMetrics const TQTabBar *t int &hframe int &vframe int &overlap This takes only the t parameter and returns a tuple of the hframe, vframe and overlap values. (TQt v2) TQWindowsXPStyle (TQt v3.0.1+, Windows) TQWindowsXPStyle is fully implemented. TQWizard (TQt v2+) TQWizard is fully implemented. TQWMatrix The Python ==, != and *= operators are supported. TQWMatrix invert const bool *invertible = 0 This takes no parameters and returns a tuple of the TQWMatrix 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. (TQt 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. (TQt v2+) TQWorkspace (TQt v2.1+) TQWorkspace is fully implemented. <Literal>qtaxcontainer</Literal> Module Reference TQAxBase (Windows, TQt v3+) TQAxObject IUnknown *iface = 0 Not implemented. long queryInterface const TQUuid &uuid void **iface Not implemented. PropertyBag propertyBag const Not implemented. void setPropertyBag const PropertyBag &bag Not implemented. unsigned long registerWeakActiveObject const TQString &guid This is a utility method provided by PyTQt 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 TQAxBase instance as a weak object with the guid GUID. The revoke handle is returned. static void revokeActiveObject unsigned long rhandle 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(). TQAxObject (Windows, TQt v3+) TQAxObject IUnknown *iface TQObject *parent = 0 const char *name = 0 Not implemented. TQAxWidget (Windows, TQt v3+) TQAxWidget IUnknown *iface TQWidget *parent = 0 const char *name = 0 Not implemented. <Literal>qtcanvas</Literal> Module Reference TQCanvas (TQt v2.2+) TQCanvas is fully implemented. TQCanvasEllipse (TQt v2.2+) TQCanvasEllipse is fully implemented. TQCanvasItem (TQt v2.2+) TQCanvasItem is fully implemented. TQCanvasItemList (TQt v2.2+) This class isn't implemented. Whenever a TQCanvasItemList is the return type of a function or the type of an argument, a Python list of TQCanvasItem instances is used instead. TQCanvasLine (TQt v2.2+) TQCanvasLine is fully implemented. TQCanvasPixmap (TQt v2.2+) TQCanvasPixmap is fully implemented. TQCanvasPixmapArray (TQt v2.2+) TQPixmapArray TQList<TQPixmap> pixmaps TQList<TQPoint> hotspots The pixmaps argument is a Python list of TQPixmap instances, and the hotspots argument is a Python list of TQPoint instances. (TQt v2.2.0 - TQt v2.3.1) TQPixmapArray TQValueList<TQPixmap> pixmaps TQPointArray hotspots = TQPointArray() The pixmaps argument is a Python list of TQPixmap instances. (TQt v3+) TQCanvasPolygon (TQt v2.2+) TQCanvasPolygon is fully implemented. TQCanvasPolygonalItem (TQt v2.2+) TQCanvasPolygonalItem is fully implemented. TQCanvasRectangle (TQt v2.2+) TQCanvasRectangle is fully implemented. TQCanvasSpline (TQt v3.0+) TQCanvasSpline is fully implemented. TQCanvasSprite (TQt v2.2+) TQCanvasSprite is fully implemented. TQCanvasText (TQt v2.2+) TQCanvasText is fully implemented. TQCanvasView (TQt v2.2+) TQCanvasView is fully implemented. <Literal>qtext</Literal> 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 (TQScintilla v1.4+) QextScintillaLexerBash is fully implemented. QextScintillaLexerBatch (TQScintilla v1.6+) QextScintillaLexerBatch is fully implemented. QextScintillaLexerCPP QextScintillaLexerCPP is fully implemented. QextScintillaLexerCSharp QextScintillaLexerCSharp is fully implemented. QextScintillaLexerCSS (TQScintilla v1.6+) QextScintillaLexerCSS is fully implemented. QextScintillaLexerDiff (TQScintilla v1.6+) QextScintillaLexerDiff is fully implemented. QextScintillaLexerHTML (TQScintilla v1.1+) QextScintillaLexerHTML is fully implemented. QextScintillaLexerIDL QextScintillaLexerIDL is fully implemented. QextScintillaLexerJava QextScintillaLexerJava is fully implemented. QextScintillaLexerJavaScript QextScintillaLexerJavaScript is fully implemented. QextScintillaLexerLua (TQScintilla v1.5+) QextScintillaLexerLua is fully implemented. QextScintillaLexerMakefile (TQScintilla v1.6+) QextScintillaLexerMakefile is fully implemented. QextScintillaLexerPerl QextScintillaLexerPerl is fully implemented. QextScintillaLexerPOV (TQScintilla v1.6+) QextScintillaLexerPOV is fully implemented. QextScintillaLexerProperties (TQScintilla v1.6+) QextScintillaLexerProperties is fully implemented. QextScintillaLexerPython QextScintillaLexerPython is fully implemented. QextScintillaLexerRuby (TQScintilla v1.5+) QextScintillaLexerRuby is fully implemented. QextScintillaLexerSQL (TQScintilla v1.1+) QextScintillaLexerSQL is fully implemented. QextScintillaLexerTeX (TQScintilla v1.6+) QextScintillaLexerTeX is fully implemented. QextScintillaMacro QextScintillaMacro is fully implemented. QextScintillaPrinter QextScintillaPrinter is fully implemented. <Literal>qtgl</Literal> Module Reference TQGL TQGL is fully implemented. TQGLContext TQGLContext is fully implemented. TQGLFormat TQGLFormat is fully implemented. TQGLWidget TQGLWidget is fully implemented. TQGLColormap (TQt v3.0+) void setEntries int count const TQRgb *colors int base = 0 Not yet implemented. <Literal>qtnetwork</Literal> Module Reference TQDns (TQt v2.2+) TQDns is fully implemented. TQFtp (TQt v2.2+) TQ_LONG readBlock char *data TQ_ULONG maxlen This takes a single maxlen parameter. The data is returned if there was no error, otherwise None is returned. TQHostAddress (TQt v2.2+) TQHostAddress TQ_UINT8 *ip6Addr Not yet implemented. TQHostAddress const Q_IPV6ADDR &ip6Addr Not yet implemented. void setAddress TQ_UINT8 *ip6Addr Not yet implemented. Q_IPV6ADDR toIPv6Address const Not yet implemented. TQHttp (TQt v3+) TQ_LONG readBlock char *data TQ_ULONG maxlen This takes a single maxlen parameter. The data is returned if there was no error, otherwise None is returned. TQHttpHeader (TQt v3.1+) TQHttpHeader is fully implemented. TQHttpRequestHeader (TQt v3.1+) TQHttpRequestHeader is fully implemented. TQHttpResponseHeader (TQt v3.1+) TQHttpResponseHeader is fully implemented. TQLocalFs (TQt v2.1+) TQLocalFs is fully implemented. TQServerSocket (TQt v2.2+) TQServerSocket is fully implemented. TQSocket (TQt v2.2+) TQ_LONG readBlock char *data TQ_ULONG len This takes a single len parameter. The data is returned if there was no error, otherwise Py_None is returned. TQ_LONG readLine char *data TQ_ULONG maxlen This takes a single maxlen parameter. The data is returned if there was no error, otherwise Py_None is returned. TQ_LONG writeBlock const char *data TQ_ULONG len len is derived from data and not passed as a parameter. TQSocketDevice (TQt v2.2+) TQ_LONG readBlock char *data TQ_ULONG len This takes a single len parameter. The data is returned if there was no error, otherwise None is returned. TQ_LONG writeBlock const char *data TQ_ULONG len len is derived from data and not passed as a parameter. <Literal>qtpe</Literal> Module Reference TQPEApplication TQApplication int& argc char **argv Type type This takes two parameters, the first of which is a list of argument strings. Arguments used by TQt are removed from the list. int exec This has been renamed to exec_loop in Python. AppLnk virtual TQString 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 TQString 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. TQCopEnvelope TQCopEnvelope is fully implemented. TQDawg TQDawg is fully implemented. TQPEMenuBar TQPEMenuBar is fully implemented. TQPEToolBar TQPEToolBar is fully implemented. Resource Resource is fully implemented. <Literal>qtsql</Literal> Module Reference TQDataBrowser (TQt v3+) virtual void del This has been renamed delOnCursor in Python. TQDataTable (TQt v3+) TQDataTable is fully implemented. TQDataView (TQt v3+) TQDataView is fully implemented. TQEditorFactory (TQt v3+) TQEditorFactory is fully implemented. TQSql (TQt v3+) TQSql is fully implemented. TQSqlCursor (TQt v3+) virtual int del bool invalidate = TRUE This has been renamed delRecords in Python. virtual int del const TQString &filter bool invalidate = TRUE This has been renamed delRecords in Python. bool exec const TQString &query This has been renamed execQuery in Python. TQSqlDatabase (TQt v3+) TQSqlQuery exec const TQString &query = TQString::null This has been renamed execStatement in Python. TQSqlDriver (TQt v3+) TQSqlDriver is fully implemented. TQSqlEditorFactory (TQt v3+) TQSqlEditorFactory is fully implemented. TQSqlError (TQt v3+) TQSqlError is fully implemented. TQSqlField (TQt v3+) TQSqlField is fully implemented. TQSqlFieldInfo (TQt v3+) TQSqlFieldInfo is fully implemented. TQSqlForm (TQt v3+) TQSqlForm is fully implemented. TQSqlIndex (TQt v3+) TQSqlIndex is fully implemented. TQSqlPropertyMap (TQt v3+) TQSqlPropertyMap is fully implemented. However, because PyTQt 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. These will simply be ignored. This problem may be addressed in a future release of PyTQt. TQSqlQuery (TQt v3+) TQMap<TQString,TQVariant> boundValues const Not yet implemented. (TQt v3.2.0+) virtual bool exec const TQString &query This has been renamed execQuery in Python. bool exec This has been renamed execQuery in Python. (TQt v3.1+) TQSqlRecord (TQt v3+) TQSqlRecord is fully implemented. TQSqlRecordInfo (TQt v3+) TQSqlRecordInfo is implemented as a Python list of TQSqlFieldInfo instances. TQSqlResult (TQt v3+) TQSqlResult is fully implemented. TQSqlSelectCursor (TQt v3.2.0+) int del bool invalidate = TRUE This has been renamed delRecords in Python. bool exec const TQString &query This has been renamed execQuery in Python. <Literal>qttable</Literal> Module Reference TQTable (TQt v2.2+) TQTable is fully implemented. TQTableItem (TQt v2.2+) TQTableItem is fully implemented. TQCheckTableItem (TQt v3+) TQCheckTableItem is fully implemented. TQComboTableItem (TQt v3+) TQComboTableItem is fully implemented. TQTableSelection (TQt v2.2+) TQTableSelection is fully implemented. <Literal>qtui</Literal> Module Reference TQWidgetFactory (TQt v3+) TQWidgetFactory is fully implemented. <Literal>qtxml</Literal> Module Reference TQDomImplementation (TQt v2.2+) TQDomImplementation is fully implemented. TQDomNode (TQt v2.2+) TQDomNode is fully implemented, including the Python == and != operators. TQDomNodeList (TQt v2.2+) TQDomNodeList is fully implemented. TQDomDocument (TQt v2.2+) bool setContent const TQCString &buffer bool namespaceProcessing TQString *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. (TQt v3+) bool setContent const TQByteArray &buffer bool namespaceProcessing TQString *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. (TQt v3+) bool setContent const TQString &text bool namespaceProcessing TQString *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. (TQt v3+) bool setContent const TQIODevice *dev bool namespaceProcessing TQString *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. (TQt v3+) bool setContent const TQCString &buffer TQString *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. (TQt v3+) bool setContent const TQByteArray &buffer TQString *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. (TQt v3+) bool setContent const TQString &text TQString *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. (TQt v3+) bool setContent const TQIODevice *dev TQString *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. (TQt v3+) bool setContent TQXmlInputSource *source TQXmlReader *reader TQString *errorMsg = 0 int *errorLine = 0 int *errorColumn = 0 Not yet implemented. (TQt v3.2.0+) TQDomDocumentFragment (TQt v2.2+) TQDomDocumentFragment is fully implemented. TQDomDocumentType (TQt v2.2+) TQDomDocumentType is fully implemented. TQDomNamedNodeMap (TQt v2.2+) TQDomNamedNodeMap is fully implemented. TQDomCharacterData (TQt v2.2+) TQDomCharacterData is fully implemented. TQDomAttr (TQt v2.2+) TQDomAttr is fully implemented. TQDomElement (TQt v2.2+) TQDomElement is fully implemented. TQDomText (TQt v2.2+) TQDomText is fully implemented. TQDomComment (TQt v2.2+) TQDomComment is fully implemented. TQDomCDATASection (TQt v2.2+) TQDomCDATASection is fully implemented. TQDomNotation (TQt v2.2+) TQDomNotation is fully implemented. TQDomEntity (TQt v2.2+) TQDomEntity is fully implemented. TQDomEntityReference (TQt v2.2+) TQDomEntityReference is fully implemented. TQDomProcessingInstruction (TQt v2.2+) TQDomProcessingInstruction is fully implemented.