changes-2.1.0

Qt 2.1 introduces new features as well as many improvements over the
2.0.x series. This file will only give an overview of the main changes
since version 2.0.2.  A complete list would simply be too large to be
useful.  For more detail see the online documentation which is included
in this distribution, and also available on
http://qt.nokia.com/doc/

The Qt version 2.1 series is binary compatible with the 2.0.x
series - applications compiled for 2.0 will continue to run with 2.1.

As with previous Qt releases, the API and functionality of Qt is
completely portable between Microsoft Windows and X11.  It is also portable
between Windows 95, 98 and NT; unlike most toolkits, Qt lets a single
executable work on all three.

****************************************************************************
*			    Overview					   *
****************************************************************************

As usual, large sections of the documentation have been revised and
lots of new documentation has been added.

Much work went into existing classes, based on all the feedback we got
from our users. A warm thank you to you all at this point, we honestly
hope to satisfy most of your wishes with the new release.

Among the things that got a lot of polishing is the new geometry
management system that was introduced with the 2.x series. Some
classes, such as QBoxLayout, have been rewritten and many size hints
and size policies were optimized. As usual with newly introduced
systems, the occasional bug has been fixed as well. As a result,
layout in Qt-2.1 is not only nicer but also faster.

Big parts of the file dialog have been rewritten. It is now
synchronized in terms of features with the common Windows dialog,
including fancy drag'n'drop and in-place renaming. You can customize
both parts of the dialog, the front-end with info and preview widgets,
the back-end with different network protocols (see the QFileDialog and
QNetworkProtocol documentation for details).

Especially interesting for dynamic Qt applications is the newly
introduced property system. Many interesting things, from scripting up
to graphical user interface builders, become easier. The technology
requires a new macro Q_PROPERTY and a new revision of Qt's meta object
compiler (moc). See the Qt documentation for details.

Due to strong customer demand, we added a cross-platform way to easily
implement multi-document interfaces (known as 'MDI'). The widget is
called QWorkspace and makes this task trivial.

On X11, text dropping from Motif drag'n'drop applications has been
added, to make your Qt applications inter-operable with those Motif
applications that survived Y2K.

The rich text system, first introduced in Qt-2.0, has been
revised. Apart from great speed improvements, it now supports HTML
tables as well as floating images.

QMultiLineEdit, the text input field in Qt, got the missing word wrap
functionality. It's probably the last big extension we will add to
that widget. In Qt 3.0, it will be replaced by a fancier, faster and
more powerful QTextEdit widget that also deals with different colors
and fonts in a way similar to the existing QTextView.

Qt follows the respective GUI style guides even more closely. This
includes honoring desktop settings, and keyboard shortcuts such as
Ctrl-Z/Y for undo/redo in line edit and multi-line edit
controls. Dialog handling for both modal and non-modal dialogs has
been improved to follow the platform conventions precisely.

With QIconView, we added a powerful new visualization widget similar
to QListView and QListBox. It contains optinally labelled pixmap items
that the user can select, drag around, rename, delete and more.

Compared to the previous release, we have managed to reduce overall
memory consumption while improving execution speed and features.

Below is a list of the major new features in existing classes as well
as short descriptions of all new classes and the changes in some of
the extensions shipped with Qt.


****************************************************************************
* 		New major features in existing classes			   *
****************************************************************************

QApplication	- new function wakeUpGuiThread() to simplify using threads
		  with Qt.

QArray		- added sorting and binary search.

QColor		- custom color support added.  qRgb(r,g,b) helper function
		  now sets an opaque alpha value instead of a transparent
		  one.

QComboBox	- support for text items with icons.

QFileDialog	- many new features including fancy drag'n'drop
		  and in-place renaming.
		  Methods like setInfoPreviewWidget()and
		  setContentsPreviewWidget() make it easy to customize
		  the dialog extensively. With QUrlOperator and the
		  QNetworkProtocol abstraction, the dialog can operate
		  transparently by various different network protocols,
		  such as HTTP and FTP (see the Network Extension).

QFocusEvent	- carries a reason() for the event. Possible reasons are
		  Mouse, Tab, ActiveWindow, ShortCut and other. The
		  addition makes line edit controls behave properly.

QHeader		- added optional visual sort indicator. Revisited API that 
		  operates on sections only (solves the 'logical' vs. 'actual' 
		  index confusion). A reworked 'table' example shows how
		  to use QHeader in combination with a scrollview to create
		  a simple spreadsheet.

QListBox	- many signals and functions added for convenience and
		  greater flexibility.

QListView	- various selections modes similar to QListBox, many
		  new functions and signals added for convenience and
		  greater flexibility.

QMainWindow	- implemented draggable and hidable toolbars. A menubar
		  can be made draggable by simply putting it in a toolbar.

QMetaObject	- Parts of the API made public. The meta object allows
		  applications to access information about an object's
		  properties as well as its signals and slots.

QMultiLineEdit	- added different word wrap modes: WidgetWidth,
		  FixedPixelWidth and FixedColumnWidth.

QObject		- property access functions property() and setProperty().

QPen		- added adjustable cap and join styles.

QPopupMenu	- added support for tear-off menus, custom items
		  and widget items.
		  A new function setItemParameter() makes it possible
		  to distinguish between several menu items connected to
		  one single slot.

QPrinter        - Now allows printing to the default printer without doing
                  setup() first.

QProgressDialog	- auto-reset and auto-close modes.

QPushButton	- added a menu button mode with setPopup().

QScrollView	- support for auto-scrolling on drag move events (drag
		  auto scroll mode).

QSignal		- optional additional integer parameter for the emitted
		  signal.

QSimpleRichText - added adjustSize() function that implements a clever
		  size hint. Vertical break support for printing. inText()
		  hit test.

QSpinBox	- different button symbols, currently UpDownArrows and
		  PlusMinus.

QSplitter	- supports three resize modes now, Stretch, KeepSize
		  and FollowSizeHint.

QString		- new functions setUnicode(), setUnicodeCodes(), setLatin1(),
		  startsWith() and endsWith()

QStringList	- new functions fromStrList(), split(), join() and grep().

QStyle		- some extensions for menu button indicators, default
		  button indicators, variable scrollbar extends and toolbar
		  handles.

QStyleSheet	- a couple of tags added to the default sheet, such as
		  U, NOBR, HEAD, DL, DT, DD and table support (TABLE, TR,
		  TD, TH). Many attributes added to existing tags.

QTextView	- basic table support. Contents is selectable, selections
		  can be pasted/dragged into other widgets.

QToolBar	- stretchable depending on the orientation (setHorizontalStretchable()
		  and setVerticalStretchable(). Added orientationChanged() signal.

QToolButton	- added optional delayed menu with setPopup() and
		  setPopupDelay(). Auto-raise behaviour adjustable.

QWidget		- new widget flag WStyle_ContextHelp that adds a
		  context-help button to the window titlebar. The
		  button triggers "What's This?"-help. The flag works
		  with MS-Windows and future versions of X11 desktops
		  such as KDE-2.0.

		- New function showFullScreen().

		- Enabling and disabling with setEnabled() propagates to
		  children.

		- Changed isVisible(). It now returns whether a widget
		  is mapped up to the toplevel widget (the previous
		  implementation only returned isVisibleTo(parentWidget()).

		- New property 'backgroundOrigin' that lets a widget draw 
		  its background relatively to its parent widget's coordinate
		  system. This makes pseudo-transparency possible, without
		  the overhead of a real widget mask.


****************************************************************************
*				New clases				   *
****************************************************************************

QCustomMenuItem	- an abstract base class for custom menu items in
		  popup menus.

QFontDataBase	- provides information about the available fonts. Not really
		  a new class (it was used internally for the QFontDialog),
		  but for the first time public API.

QGuardedPtr	- a template class that provides guarded pointers to
		  QObjects.

QIconView	- a sophisticated new widget similar to QListView and
		  QListBox.  An iconview contains optinally labelled pixmap
		  items that the user can select, drag around, rename, delete
		  and more. The widget is highly optimized for speed and
		  large amounts of icons.

QInputDialog	- a convenience dialog to get some simple input values from
		  the user.

QMetaProperty	- stores meta data about properties. Part of the meta
		  object system.

QNetworkProtocol- base class for network protocols, provides
		  a common API for network protocols.

QUrl/
QUrlOperator	- provides an easy way to work with URLs.

QVariant	- a tagged union for the most common Qt data types.

QValueStack	- a value-based stack container.

QWorkspace	- provides a workspace that can contain decorated
		  windows as opposed to frameless child widgets.
		  QWorkspace makes it easy to implement a multi-document
		  interface (MDI).

QBig5Codec	- provides support for the Big5 Chinese encoding.


****************************************************************************
*		Changes which may affect runtime behaviour		   *
****************************************************************************

QDataStream / QPicture
 To accomodate for improved functionality, the stream serialization format
 of QString and QPen has changed in Qt 2.1. The format version
 number has been increased to 3. Compatibility has been kept, so
 applications built with this version of Qt are automatically able to read
 QDataStream and QPicture data generated by earlier Qt 2.x versions. But if
 your application needs to generate data that must be readable by
 applications that are compiled with earlier versions of Qt, you must use
 QDataStream::setVersion() (if the data contains QString or QPen objects).
 See the documentation of this function for further discussion.

QPainter::drawPolygon()
 An outline is no longer drawn in the brush color if NoPen is specified.
 This matches the behaviour on Windows and ensures that the area
 painted in this case is the same pixels defined by a QRegion made
 from the polygon.  To get the old behaviour, you can call
 painter.setPen(painter.brush()) prior to painting, which will also
 work on Windows.

QPushButton::sizeHint()
 The size hint of auto-default push buttons has been slightly
 increased in order to reserve space for a default button indicator
 frame. This is necessary for a proper Motif or Platinum emulation. If
 this change destroys your geometry management, a auto-default button
 is probably not what you wanted anyway. Simply call
 setAutoDefault(FALSE) on these push buttons to get the old behaviour.

QWidget
 Font and palette propagation has changed totally (from "almost
 brain-dead" to working).  In practice, the only changes we've seen are
 to the better.

QColor
 qRgb(r,g,b) now sets a default opaque alpha value of 0xff instead of
 a transparent 0x00 alpha value formerly.  Use qRgb(r,g,b,a) if you do
 need a transparent alpha value.

QPalette
 It turned out that the old normal/active/disabled set of color groups
 didn't work very well, except in the simplest hello-world examples,
 that it couldn't be fixed without nasty hacks, and that during five
 years nobody had discovered the bugs.  So, we've dropped our broken
 attempt at Tcl/Tk L&F compatibility, and added support for Windows
 2000 and Macintosh L&F compatibility instead.  The Macintosh and
 Windows 2000 looks differentiate between the window with focus and
 other windows.  Qt calls the color groups QPalette::active() and
 QPalette::inactive() respectively.

QGridLayout/QBoxLayout 
 setMargin() now also works on child layouts. As a result of this
 change, the geometry() of a layout now includes margin(). This may
 effect programs that use QLayout::geometry().

QToolButton
 The now adjustable auto-raise behaviour defaults to TRUE only when
 a button is used inside a QToolBar. That's usually what you want. If not,
 call setAutoRaise(FALSE).