Revision control

++ Qt 3.1 introduces many significant new features and many improvements
++ over the 3.0.x series. This file provides an overview of the main
++ changes since version 3.0.5. For further details see the online
++ documentation which is included in this distribution, and also
++ available at http://qt.nokia.com/doc/.
++
++ The Qt version 3.1 series is binary compatible with the 3.0.x series:
++ applications compiled for 3.0 will continue to run with 3.1.
++
++
++ ****************************************************************************
++ * General *
++ ****************************************************************************
++
++ Qt Script for Applications
++ --------------------------
++ Qt 3.1 is the first Qt release that can be used with Qt Script for
++ Applications (QSA). QSA provides a scripting engine, an IDE for
++ creating and editing scripts and script forms, and bindings to the Qt
++ API. Script-enabling a Qt application is not difficult and the IDE
++ makes it easy for resellers and end-users to write their own scripts.
++ QSA is due for release after Qt 3.1.
++
++
++ Qt Designer
++ -----------
++ Qt Designer, the visual GUI builder, has undergone several usability
++ improvements. A new dialog for creating and editing signals and slots
++ connections has been created: it is much easier to use and much faster
++ for setting up multiple connections. The widgets are now presented in
++ an easy-to-use toolbox rather than in toolbars (although you can still
++ have the toolbars if you want). The property editor now handles common
++ properties in multiple widgets simultaneously. By popular demand,
++ WYSIWYG support for QWidgetStack has been added. Rich text is now
++ supported with a rich text editor. And the code editor can be used for
++ ordinary member functions as well as for slots.
++
++
++ Qt Assistant
++ ------------
++ Qt Assistant, the Qt documentation browser, can now be used with
++ custom documentation sets. This new functionality combined with the
++ new QAssistantClient class means that you can use Qt Assistant as a
++ help browser for your own applications. Qt Assistant has also been
++ enhanced by the addition of a fast full text search engine.
++
++
++ Motif
++ -----
++ The general industry-wide move away from Motif is leaving more and
++ more companies in need of a migration solution. But converting large
++ legacy applications in one step is often impractical. To minimize
++ risks and to manage the workload companies often want to port code on
++ a module by module basis. Qt 3.1 includeds a completely new Motif
++ module that supports hybrid applications in which Qt code and Motif
++ code coexist. (This obsoletes the earlier rudimentary Qt Xt/Motif
++ extension.)
++
++
++ ActiveX
++ -------
++ With the release of Qt 3.1, customers who use Qt for Microsoft Windows
++ development can now use Qt with ActiveX. The new ActiveQt module
++ provides a simple API for COM and ActiveX. The module can be used to
++ create applications which host ActiveX controls, and also to create
++ applications that serve ActiveX controls (e.g. Internet Explorer
++ plugins).
++
++
++ Qt/Mac
++ ------
++ The introduction of Qt/Mac, a Mac OS X port of Qt, with Qt 3.0 has
++ proved a great success. This port has undergone many improvements in
++ Qt 3.1, especially with respect to Appearance Manager, anti-aliased
++ text and user settings. The Qt OpenGL support is greatly improved, and
++ uses the hardware-accelerated drivers.
++
++
++ Qt/Embedded
++ -----------
++ Graphics, mouse and keyboard drivers can now be compiled as plugins.
++
++
++ Qt library
++ ----------
++ In addition to the new additions and enhancements referred to above,
++ as with all major Qt releases, Qt 3.1 includes hundreds of
++ improvements in the existing class library. Here is a brief summary of
++ the most significant changes:
++
++ - QTextEdit has a new text format: LogText. This is a performance and
++ memory optimized format especially designed for the fast display of
++ large amounts of text. The format supports basic highlighting,
++ including bold and colored text.
++
++ - The new QSyntaxHighlighter class makes it both easy and efficient to
++ add syntax highlighting capabilities to a QTextEdit.
++
++ - QHttp and QFtp in earlier Qt's were implementations of the
++ QNetworkProtocol. Both have been extended to stand in their own
++ right. If you missed some flexibility in the network protocol
++ abstractions of earlier Qt's, the new QHttp and QFtp classes should
++ provide the solution.
++
++ - QAccel, used to handle keyboard shortcuts, now gracefully copes with
++ shortcut clashes. If a clash occurs, a new signal,
++ activatedAmbiguously(), is emitted. Classes that use QAccel, like
++ QButton and QPopupMenu, make use of this new functionality.
++ Futhermore QAccel can now handle multi-key sequences, for example,
++ Ctrl+X,Ctrl+F.
++
++ - QClipboard has been extended to simplify data exchange between
++ programs.
++
++ - Thread support: almost all methods in the tools classes have been
++ made reentrant. QApplication::postEvent() and a few other methods
++ are now thread-safe if Qt is compiled as a multi-threaded library.
++ (The documentation now states if a class or function is thread-safe
++ or reentrant.)
++
++ - A QMutexLocker class has been added to simplify the locking and
++ unlocking of mutexes.
++
++ - Input methods: A selectionLength() function has been added to
++ QIMEvent. Japanese compositions are now handled correctly. Support
++ for AIMM based input methods (those working on non-Asian versions of
++ Win95/98/Me) has been added.
++
++ - Large File support: Qt's internals have been modified to support
++ Large Files (> 2GB). QFileDialog will now correctly display and
++ select Large Files.
++
++ - SQL module: Support for prepared query execution and value binding
++ has been added. Among other benefits, this makes it possible to
++ write large BLOBs (> 2 KB) to Oracle databases, and to write Unicode
++ strings to SQL Server databases.
++
++
++ Build process
++ -------------
++ The build process has been improved:
++
++ - The configure script does not need QTDIR to be set anymore.
++
++
++ ****************************************************************************
++ * Library *
++ ****************************************************************************
++
++ New classes
++ ==================
++
++ - QBackInsertIterator
++ - QEventLoop
++ - QIconFactory
++ - QMutexLocker
++ - QSyntaxHighlighter
++
++
++ QAction
++ ------------------
++ New functions:
++ void setVisible( bool )
++ bool isVisible() const
++
++
++ QCanvas
++ ------------------
++ New functions:
++ void invalidate()
++ bool isValid() const
++
++
++ QColorDialog
++ ------------------
++ New functions:
++ static void setStandardColor( int, QRgb )
++
++
++ QAccel
++ ------------------
++ New signals:
++ void activatedAmbiguously( int id )
++
++
++ QApplication
++ ------------------
++ The event loop has been moved to the QEventLoop class, making it
++ easier to integrate other toolkits with Qt.
++
++ New functions:
++ QEventLoop *eventLoop() const
++ void setEventLoop( QEventLoop * )
++ QString sessionKey() const
++
++
++ QClipboard
++ ------------------
++ New functions:
++ void clear( Mode mode )
++ bool supportsSelection() const
++ bool ownsSelection() const
++ bool ownsClipboard() const
++ QString text( Mode mode ) const
++ QString text( QCString& subtype, Mode mode ) const
++ void setText( const QString &, Mode mode )
++ QMimeSource *data( Mode mode ) const
++ void setData( QMimeSource*, Mode mode )
++ QImage image( Mode mode ) const
++ QPixmap pixmap( Mode mode ) const
++ void setImage( const QImage &, Mode mode )
++ void setPixmap( const QPixmap &, Mode mode )
++
++
++ QDesktopWidget
++ ------------------
++ New functions:
++ const QRect& screenGeometry( QWidget *widget ) const
++ const QRect& screenGeometry( const QPoint &point ) const
++ const QRect& availableGeometry( int screen ) const
++ const QRect& availableGeometry( QWidget *widget ) const
++ const QRect& availableGeometry( const QPoint &point ) const
++
++
++ QFileDialog
++ ------------------
++ Large Files (> 2GB) are now correctly displayed and selected.
++
++
++ QFileInfo
++ ------------------
++ QFileInfo now supports Large Files (> 2GB) internally. To maintain
++ binary compatibility the QFileInfo API cannot be adapted before Qt 4
++ and will truncate file sizes and offsets to 4 GB.
++
++ New functions:
++ bool isHidden() const
++
++
++ QFile
++ ------------------
++ QFile now supports Large Files (> 2GB) internally. To maintain binary
++ compatibility the QFile API cannot be adapted before Qt 4 and will
++ truncate file sizes and offsets to 4 GB.
++
++
++ QDir
++ ------------------
++ QDir now supports Large Files (> 2GB).
++
++
++ QImEvent
++ ------------------
++ New functions:
++ in selectionLength() const
++
++
++ QIconSet
++ ------------------
++ New functions:
++ void installIconFactory( QIconFactory *factory )
++
++
++ QImage
++ ------------------
++ New functions:
++ static QImage fromMimeSource( const QString& abs_name )
++
++
++ QMetaObject
++ ------------------
++ New functions:
++ QStrList enumeratorNames( bool super ) const
++ int numEnumerators( bool super ) const
++ static bool hasMetaObject( const char *class_name )
++
++
++ QMenuData
++ ------------------
++ New functions:
++ bool isItemVisible( int id ) const
++ void setItemVisible( int id, bool visible )
++ Both functions are inherited by QMenuBar and QPopupMenu
++
++
++ QPaintDevice
++ ------------------
++ New functions (x11 only):
++ static Qt::HANDLE x11AppRootWindow()
++ static int x11AppDepth( int screen )
++ static int x11AppCells( int screen )
++ static Qt::HANDLE x11AppRootWindow( int screen )
++ static Qt::HANDLE x11AppColormap( int screen )
++ static void *x11AppVisual( int screen )
++ static bool x11AppDefaultColormap( int screen )
++ static bool x11AppDefaultVisual( int screen )
++ static int x11AppDpiX( int )
++ static int x11AppDpiY( int )
++ static void x11SetAppDpiX( int, int )
++ static void x11SetAppDpiY( int, int )
++
++
++ QPicture
++ ------------------
++ New functions:
++ void setBoundingRect( const QRect &r )
++
++
++ QPixmap
++ ------------------
++ New functions:
++ bool hasAlpha() const
++ static QPixmap fromMimeSource( const QString& abs_name )
++
++
++ QPrinter
++ ------------------
++ New functions:
++ void setMargins( uint top, uint left, uint bottom, uint right )
++ void margins( uint *top, uint *left, uint *bottom, uint *right ) const
++
++ Improvements:
++ Handle masked images and pixmaps correctly. Add code to handle
++ asymmetrical printer margins correctly.
++
++
++ QSessionManager
++ ------------------
++ New functions:
++ QString sessionKey() const
++
++
++ QStyleOption
++ ------------------
++ New functions:
++ QStyleOption( QCheckListItem* i )
++ QCheckListItem* checkListItem() const
++
++ New enums values:
++ PE_CheckListController, PE_CheckListIndicator,
++ PE_CheckListExclusiveIndicator, PE_PanelGroupBox
++ CE_MenuBarEmptyArea
++ CE_DockWindowEmptyArea
++ PM_CheckListButtonSize
++ CT_TabBarTab, CT_Slider, CT_Header, CT_LineEdit
++ SH_GroupBox_TextLabelVerticalAlignment
++
++
++ QThread
++ ------------------
++ New functions:
++ void terminate()
++
++
++ QTranslator
++ ------------------
++ New functions:
++ bool load( const uchar *data, int len )
++
++
++ QVariant
++ ------------------
++ New functions:
++ QVariant( const QPen& )
++ const QPen toPen() const
++ QPen& asPen()
++ bool isNull() const
++
++ New enum values:
++ KeySequence, Pen
++
++
++ QWidget
++ ------------------
++ All top-level widgets will now try to find an appropriate application
++ icon when they're not given one, trying in this order
++ 1. Parent widget's icon
++ 2. Top-level widget's icon
++ 3. Application main widget's icon
++
++ New functions:
++ bool isFullScreen() const
++ void setSizePolicy( QSizePolicy::SizeType hor, QSizePolicy::SizeType ver, bool hfw = FALSE )
++
++ New enum values:
++ AncestorOrigin
++
++
++ QWMatrix
++ ------------------
++ Two different transformation modes for painter transformations are now
++ available. See the QWMatrix documentation for details.
++
++ New functions:
++ QPointArray mapToPolygon( const QRect &r ) const
++ double det() const
++ static void setTransformationMode( QWMatrix::TransformationMode m )
++ static TransformationMode transformationMode()
++
++ New enums:
++ TransformationMode { Points, Areas }
++
++
++ QFtp
++ ------------------
++ While still remaining a subclass of QNetworkProtocol, QFtp can be now
++ used directly for more advanced FTP operations. The QFtp documentation
++ provides details of the extensions to the API.
++
++
++ QHttp
++ ------------------
++ While still remaining a subclass of QNetworkProtocol, QHttp can be now
++ used directly for more advanced HTTP operations. The QHttp
++ documentation provides details of the extensions to the API.
++
++ Related new classes:
++ QHttpHeader
++ QHttpResponseHeader
++ QHttpRequestHeader
++
++
++ QSqlDriver
++ ------------------
++ New enum values:
++ Unicode, PreparedQueries, OracleBindingStyle, ODBCBindingStyle
++
++
++ QSqlQuery
++ ------------------
++ New functions:
++ bool isForwardOnly() const
++ void setForwardOnly( bool forward )
++ bool exec()
++ bool prepare( const QString& query )
++ void bindValue( const QString& placeholder, const QVariant& val )
++ void bindValue( int pos, const QVariant& val )
++ void addBindValue( const QVariant& val )
++
++
++ QTableSelection
++ ------------------
++ New functions:
++ QTableSelection( int start_row, int start_col, int end_row, int end_col )
++
++
++ QTable
++ ------------------
++ New properties:
++ int numSelections
++
++ New functions:
++ void selectCells( int start_row, int start_col, int end_row, int end_col )
++ void selectRow( int row )
++ void selectColumn( int col )
++ void updateHeaderStates()
++ void setRowLabels( const QStringList &labels )
++ void setColumnLabels( const QStringList &labels )
++
++
++ QCString
++ ------------------
++ New functions:
++ QCString &replace( char c, const char *after )
++ QCString &replace( const char *, const char * )
++ QCString &replace( char, char )
++
++ New global functions:
++ QByteArray qCompress( const uchar* data, int nbytes )
++ QByteArray qUncompress( const uchar* data, int nbytes )
++ QByteArray qCompress( const QByteArray& data )
++ QByteArray qUncompress( const QByteArray& data )
++ Improvements:
++ Speed optimisations in lots of the old search and replace
++ functions.
++
++
++ QDate
++ ------------------
++ New functions:
++ int weekNumber( int *yearNum = 0 ) const
++ static QDate currentDate( Qt::DateTimeSpec )
++
++
++ QTime
++ ------------------
++ New functions:
++ static QTime currentTime( Qt::DateTimeSpec )
++
++
++ QDateTime
++ ------------------
++ New functions:
++ static QDateTime currentDateTime( Qt::DateTimeSpec )
++
++
++ QPtrList
++ ------------------
++ New functions:
++ bool replace( uint i, const type *d )
++
++
++ QRegExp
++ ------------------
++ New functions:
++ QString errorString()
++ static QString escape( const QString& str )
++ int numCaptures() const
++
++
++ QSettings
++ ------------------
++ New functions:
++ QSettings( Format format )
++ void setPath( const QString &domain, const QString &product, Scope = User )
++ void beginGroup( const QString &group )
++ void endGroup()
++ void resetGroup()
++ QString group() const
++
++ New enums:
++ Format { Native = 0, Ini }
++ Scope { User, Global }
++
++
++ QChar
++ ------------------
++ Updated Unicode tables to Unicode-3.2
++
++
++ QString
++ ------------------
++ New functions:
++ QString &append( const QByteArray & )
++ QString &append( const char * )
++ QString &prepend( const QByteArray & )
++ QString &prepend( const char * )
++ QString &remove( QChar c )
++ QString &remove( char c )
++ QString &remove( const QString & )
++ QString &remove( const QRegExp & )
++ QString &remove( const char * )
++ QString &replace( uint index, uint len, QChar )
++ QString &replace( uint index, uint len, char c )
++ QString &replace( QChar c, const QString & )
++ QString &replace( char c, const QString & after )
++ QString &replace( const QString &, const QString & )
++ QString &replace( QChar, QChar )
++ QString &operator+=( const QByteArray &str )
++ QString &operator+=( const char *str )
++ static QString fromUcs2( const unsigned short *ucs2 )
++ const unsigned short *ucs2() const
++
++ Improvements:
++ find(), findRev() and contains() use either a fast hashing
++ algorithm (for short strings) or an optimized Boyer-Moore
++ implementation for long strings. Lots of smaller performance
++ optimisations.
++
++
++ QTextStream
++ ------------------
++ New functions:
++ QTextCodec *codec()
++
++
++ QTimeEdit
++ ------------------
++ New properties:
++ Display display
++
++ New functions:
++ uint display() const
++ void setDisplay( uint )
++
++ New enums:
++ Display { Hours, Minutes, Seconds, AMPM }
++
++
++ QFrame
++ ------------------
++ New enum values:
++ GroupBoxPanel
++
++
++ QGroupBox
++ ------------------
++ New properties:
++ bool flat
++
++ New functions:
++ bool isFlat() const
++ void setFlat( bool b )
++
++
++ QListBox
++ ------------------
++ New functions:
++ QListBoxItem* selectedItem() const
++
++
++ QListView
++ ------------------
++ New functions:
++ int sortColumn() const
++
++
++ QSlider
++ ------------------
++ New functions:
++ void addLine() ( as slot)
++ void subtractLine() (as slot)
++
++
++ QTextBrowser
++ ------------------
++ New functions:
++ void sourceChanged( const QString& )
++ void anchorClicked( const QString&, const QString& )
++
++
++ QTextEdit
++ ------------------
++ QTextEdit offers another TextFormat (LogText), which is optimized
++ (speed and memory) for displaying large read-only texts normally used
++ for logging.
++
++ New properties:
++ bool allowTabs
++
++ New functions:
++ QString anchorAt( const QPoint& pos, AnchorAttribute a )
++ void setAllowTabs( bool b )
++ bool allowTabs() const
++ void insert( const QString &text, uint insertionFlags = CheckNewLines | RemoveSelected )
++
++ New signals:
++ void clicked( int parag, int index )
++ void doubleClicked( int parag, int index )
++
++ New enums:
++ TextInsertionFlags { RedoIndentation, CheckNewLines, RemoveSelected }
++
++ New enum values:
++ AtWordOrDocumentBoundary
++
++
++ QToolButton
++ ------------------
++ New properties:
++ TextPosition textPosition
++
++ New functions:
++ TextPosition textPosition() const
++ void setTextPosition( TextPosition pos )
++
++ New enums:
++ TextPosition { Right, Under }
++
++
++ QTooltip
++ ------------------
++ New functions:
++ static void setWakeUpDelay( int )
++
++
++ QWhatsThis
++ ------------------
++ New functions:
++ static void setFont( const QFont &font )
++
++
++ QDomDocument
++ ------------------
++ New functions:
++ QString toString( int ) const
++ QCString toCString( int ) const
++
++
++ QFont on X11
++ ------------------
++ Improvements:
++ Safe handling of huge font sizes. Added support for the new
++ Xft2 font library on XFree-4.x.
++
++
++ QRegion on X11
++ ------------------
++ Improvements:
++ Removed the 16 bit size limitation
++
++ ****************************************************************************