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;