Qt 3.0 Beta2 is not binary compatible with Beta1, this means that any programs linked with Beta1 must be recompiled. Below you'll find a description of general changes in the Qt Library and Qt Designer followed by a detailed list of changes in the programming API. The Qt Library ======================================== Wacom Tablet Support -------------------- Support for Wacom brand tablets has been introduced on Irix and Windows. These devices generate a QTabletEvent that can be handled by QWidget::tabletEvent(). The QTabletEvent holds information about pressure, X and Y tilt, and which device is being used (e.g. stylus or eraser). Note: at present, there are known issues with the Windows version. Documentation ------------- Overall enhancements including fixed typos and the addition of several images and code examples. QStyle (and derived classes) ---------------------------- The style API has been completely rewritten in Qt 3.0. The main reason for doing this was because it was getting inconsistent, hard to maintain and extend. Most of the old 2.x functions have been replaced by a small set of more general functions. The new API is: - much more consistent - less work have to be done to create custom styles - easier to extend and maintain binary compatibility The old API relied upon a host of virtual functions that were re-implemented in the different styles. These functions were used to draw parts of, or entire widgets. The new API uses a small set of more general functions. Enumerated values are passed as parameters to these functions to specify which parts of a control or widget is to be drawn (e.g drawPrimitive( PE_ArrowUp, ...)). To create custom styles with the new API, simply subclass from the preferred base style and re-implement the function that draws the part of the widget you want to change. If you for example want to change the look of the arrows that are used in QWindowsStyle, subclass from it and re-implement the drawPrimitive() function. Your drawPrimitive() function may look something like this: void QMyStyle::drawPrimitive( PrimitiveElement pe, ... ) { switch( pe ) { case PE_ArrowUp: // draw up arrow break; case PE_ArrowDown: // draw down arrow break; default: // let the base class handle the rest of the drawing QWindowsStyle::drawPrimitive( ... ); break; } } For more information about the new style API, please read the QStyle documentation. Qt Designer ======================================== - Improved indentation algorithm for the code editor. - Allow multiple code editors to be open. This makes copy and paste much easier. Qt Functions ======================================== QCanvas ------- - QCanvas does not react on windowActivationChange() anymore. - 64 bit cleanup. QChar ----- - The Unicode character is stored host ordered now. Main advantage is that you can directly cast a QChar array to an array of unsigned shorts. QCom ---- - Introduced QS_OK, QS_FALSE, QE_NOINTERFACE, QE_INVALIDARG and QE_NOIMPL as possible QRESULT return values. QDate, QTime and QDateTime -------------------------- - New function for outputting free form strings and new DateFormat enum Qt::LocalDate. New functions: QString toString( const QString& format ); QDir ---- - entryInfoList() returns 0 for non-existing directories on Windows as the documentation claims and the Unix version already does. - On Windows, QDir tries a more failsafe way to determine the home directory. QDom ---- - QDomNode::hasChildNodes() now works as documented. - QDomDocument::toString() includes now namespaces in its output. - QDomDocument::QDomDocument() constructor now allows adding children to the document. QFileDialog ----------- - Various fixes in file type filter and handling of file names and directories. QEvent ------ - New event type DeferredDelete. See QObject changes below. QGL --- - Fix for Irix in respect of installing colormaps. - Swapped arguments of QGLColormap::setEntries() in order to be able to use a meaningful default argument. New class: QGLColormap - class for manipulating colormaps in GL index mode. QGridView --------- A new class that provides an abstract base for fixed-size grids. QIconSet -------- New function: void clearGenerated(); QImage ------ - Handlers for image formats can be dynamically loaded as a plug-in by using the QImageFormatInterface. QLabel ------ - setIndent() behaves like documented. QLineEdit --------- New function: int characterAt( int xpos, QChar *chr ) const; QLibrary -------- Enabled plug-in loading with static Qt library (Windows). QMovie ------ - Does pixmap caching now. Reduces load e.g. on the X Server in the case of animated gifs. QObject ------- - Added a deferredDelete() function that will cause the object to delete itself once the event loop is entered again. - A second type of destroyed signal - one that passes a pointer to the destroyed object as a parameter - will be emitted in QObject's destructor. New signal: void destroyed( QObject* obj ); New slot: void deferredDelete(); QPainter -------- - So far clipping had always been done in the device coordinate system. The newly introduced ClipMode allows clipping regions to be set via setClipRect() and setClipRegion() in painter coordinates. New enum: enum ClipMode { ClipDevice, ClipPainter }; Extended functions: QRegion clipRegion( ClipMode = ClipDevice ) const; void setClipRect( const QRect &, ClipMode = ClipDevice ) void setClipRect( int x, int y, int w, int h, ClipMode = ClipDevice ); void setClipRegion( const QRegion &, ClipMode = ClipDevice ); QPrintDialog ------------ - Allow overriding the default print dialog. This way it's possible to better cope with the variety of existing print systems (API not finalized, yet). - The dialog reads current QPrinter on every invocation now. New functions: static void setGlobalPrintDialog( QPrintDialog * ); virtual bool setupPrinters ( QListView *printers ); QPrinter -------- - X11 version only: Introduced Qt settings switch 'embedFonts' that allows disabling font embedding to reduce size of PostScript output. QProcess -------- - Added function to retrieve the pid (Unix) or PROCESS_INFORMATION (Windows) from a running process. - Extra parameter for environment settings in start() and launch() functions. New/extended functions: PID processIdentifier(); virtual bool start( QStringList *env=0 ); virtual bool launch( const QString& buf, QStringList *env=0 ); virtual bool launch( const QByteArray& buf, QStringList *env=0 ); New signal: void launchFinished(); QServerSocket ------------- - Set the SO_REUSEADDR option so that the server can be restarted. QSocket ------- - Make deletion of QSocket instances safe if it is in response to a signal emitted by the object itself. SocketDevice ------------ - Optional boolean parameter to be able to distinguish between timeout and connection closed by peer when waitForMore() returns. Extended functions: int waitForMore( int msecs, bool *timeout=0 ) const; QStyleSheet ----------- - Added helper function that escapes HTML meta-characters. New function: QString escape( const QString& plain); QSql ---- - The source of the SQL driver plug-ins have been moved to $QTDIR/plugins/src/sqldrivers/. - The postgres driver checks the version number of the server. So there is no need for different drivers: QPSQL6 no longer exists -- use QPSQL7 instead. - Postgres driver supports now 3 PostgreSQL back ends: 6.x, 7.0.x and 7.1.x - Better handling of errors coming from the database. - SQL driver for Microsoft SQL Server and Sybase Adaptive Server (TDS). - Added caching for forward-only cursors. - Avoid crashes on the unloading of SQL plugins that occurred on some platforms. - QSqlResults can be forward only to improve performance (QSqlResult::setForwardOnly()). - QSqlDatabase passes the port number to the SQL driver. QTable ------ - No longer calls processEvents() in columnWidthChanged() and rowHeightChanged() in order to avoid any side effects. - Ensure that mousePressEvent doesn't emit contextMenuRequested(), unless it is called from the contextMenu event handler. - For more useful subclassing the new functions listed below have been added. New functions: bool isEditing() const; EditMode editMode() const; int currEditRow() const; int currEditCol() const; QTextCodec ---------- - Fixes for characters in the 0x80..0xff range. QTextEdit --------- - The rich text engine has seen many internal improvements and additions to the QTextEdit class. New functions: virtual void scrollToBottom(); virtual void removeSelection( int selNum = 0 ); virtual bool getParagraphFormat(...); virtual void insertParagraph( const QString &text, int para ); virtual void removeParagraph( int para ); virtual void insertAt( const QString &text, int para, int index ); QRect paragraphRect( int para ) const; int paragraphAt( const QPoint &pos ) const; int charAt( const QPoint &pos, int *para ) const; QUrlOperator ------------ - More precise error messages. QWidget ------- - Added a read-only property containing the widget's background brush. New function: virtual const QBrush& backgroundBrush() const; QWMatrix -------- - New functions for mapping of geometric elements via matrix multiplication semantics. New functions: QRect mapRect( const QRect & ); QPoint operator * (const QPoint & ) const; QRegion operator * (const QRect & ) const; QRegion operator * (const QRegion & ) const; QPointArray operator * ( const QPointArray &a ) const;