1 Qt 3.0 adds a lot of new features and improvements over the Qt 2.x

     2 series. Some internals have undergone major redesign and new classes

     3 and methods have been added.

     4 

     5 We have tried to keep the API of Qt 3.0 as compatible as possible with

     6 the Qt 2.x series. For most applications only minor changes will be

     7 needed to compile and run them successfully using Qt 3.0.

     8 

     9 One of the major new features that has been added in the 3.0 release

    10 is a module allowing you to easily work with databases. The API is

    11 platform independent and database neutral. This module is seamlessly

    12 integrated into Qt Designer, greatly simplifying the process of

    13 building database applications and using data aware widgets.

    14 

    15 Other major new features include a component architecture allowing you

    16 to build cross platform components, 'plugins' with Qt. You can use

    17 your own and third party plugins your own applications. The Unicode

    18 support of Qt 2.x has been greatly enhanced, it now includes full

    19 support for scripts written from right to left (e.g. Arabic and

    20 Hebrew) and also provides improved support for Asian languages.

    21 

    22 Many new classes have been added to the Qt Library. Amongst them are

    23 classes that provide a docking architecture (QDockArea/QDockWindow), a

    24 powerful rich text editor (QTextEdit), a class to store and access

    25 application settings (QSettings) and a class to create and communicate

    26 with processes (QProcess).

    27 

    28 Apart from the changes in the library itself a lot has been done to

    29 make the development of Qt applications with Qt 3.0 even easier than

    30 before. Two new applications have been added: Qt Linguist is a tool to

    31 help you translate your application into different languages; Qt

    32 Assistant is an easy to use help browser for the Qt documentation that

    33 supports bookmarks and can search by keyword.

    34 

    35 Another change concerns the Qt build system, which has been reworked

    36 to make it a lot easier to port Qt to new platforms. You can use this

    37 platform independent build system for your own applications.

    38 

    39 

    40 The Qt Library

    41 ========================================

    42 

    43 A large number of new features has been added to Qt 3.0. The following

    44 list gives an overview of the most important new and changed aspects

    45 of the Qt library. A full list of every new method follows the

    46 overview.

    47 

    48 

    49 Database support

    50 ----------------

    51 

    52 One of the major new features in Qt 3.0 is the SQL module that

    53 provides cross-platform access to SQL databases, making database

    54 application programming with Qt seamless and portable. The API, built

    55 with standard SQL, is database-neutral and software development is

    56 independent of the underlying database.

    57 

    58 A collection of tightly focused C++ classes are provided to give the

    59 programmer direct access to SQL databases. Developers can send raw SQL

    60 to the database server or have the Qt SQL classes generate SQL queries

    61 automatically.  Drivers for Oracle, PostgreSQL, MySQL and ODBC are

    62 available and writing new drivers is straightforward.

    63 

    64 Tying the results of SQL queries to GUI components is fully supported

    65 by Qt's SQL widgets. These classes include a tabular data widget

    66 (for spreadsheet-like data presentation with in-place editing), a

    67 form-based data browser (which provides data navigation and edit

    68 functions) and a form-based data viewer (which provides read-only

    69 forms). This framework can be extended by using custom field editors,

    70 allowing for example, a data table to use custom widgets for in-place

    71 editing. The SQL module fully supports Qt's signal/slots mechanism,

    72 making it easy for developers to include their own data validation and

    73 auditing code.

    74 

    75 Qt Designer fully supports Qt's SQL module. All SQL widgets can be

    76 laid out within Qt Designer, and relationships can be established

    77 between controls visually. Many interactions can be defined purely in

    78 terms of Qt's signals/slots mechanism directly in Qt Designer.

    79 

    80 

    81 Component model - plugins

    82 -------------------------

    83 

    84 The QLibrary class provides a platform independent wrapper for runtime

    85 loading of shared libraries. Access to the shared libraries uses a

    86 COM-like interface. QPluginManager makes it trivial to implement

    87 plugin support in applications. The Qt library is able to load

    88 additional styles, database drivers and text codecs from plugins which

    89 implement the relevant interfaces, e.g. QStyleFactoryInterface,

    90 QSqlDriverInterface or QTextCodecInterface. It is possible to remove

    91 unused components from the Qt library, and easy to extend any

    92 application with 3rd party styles, database drivers or text codecs.

    93 

    94 Qt Designer supports custom widgets in plugins, and will use the

    95 widgets both when designing and previewing forms.

    96 

    97 QComponentFactory makes it easy to register any kind of component in a

    98 global database (e.g. the Windows Registry) and to use any registered

    99 component.

   100 

   101 

   102 Rich text engine and editor

   103 ---------------------------

   104 

   105 The rich text engine originally introduced in Qt 2.0 has been further

   106 optimized and extended to support editing. It allows editing formatted

   107 text with different fonts, colors, paragraph styles, tables and

   108 images. The editor supports different word wrap modes, command-based

   109 undo/redo, multiple selections, drag and drop, and many other

   110 features.  The engine is highly optimized for proccesing and displaying

   111 large documents quickly and efficiently.

   112 

   113 

   114 Unicode

   115 -------

   116 

   117 Apart from the rich text engine, another new feature of Qt 3.0 that

   118 relates to text handling is the greatly improved Unicode support. Qt

   119 3.0 includes an implementation of the bidirectional algorithm (BiDi)

   120 as defined in the Unicode standard and a shaping engine for Arabic,

   121 which gives full native language support to Arabic and Hebrew speaking

   122 people. At the same time the support for Asian languages has been

   123 greatly enhanced.

   124 

   125 The support is almost transparent for the developer using Qt to

   126 develop their applications. This means that developers who developed

   127 applications using Qt 2.x will automatically gain the full support for

   128 these languages when switching to Qt 3.0. Developers can rely on their

   129 application to work for people using writing systems different from

   130 Latin1, without having to worry about the complexities involved with

   131 these scripts, as Qt takes care of this automatically.

   132 

   133 

   134 Docked and Floating Windows

   135 ---------------------------

   136 

   137 Qt 3.0 introduces the concept of Dock Windows and Dock Areas. Dock

   138 windows are widgets, that can be attached to, and detached from, dock

   139 areas. The commonest kind of dock window is a tool bar. Any number of

   140 dock windows may be placed in a dock area. A main window can have dock

   141 areas, for example, QMainWindow provides four dock areas (top, left,

   142 bottom, right) by default. The user can freely move dock windows and

   143 place them at a convenient place in a dock area, or drag them out of

   144 the application and have them float freely as top level windows in

   145 their own right. Dock windows can also be minimized or hidden.

   146 

   147 For developers, dock windows behave just like ordinary widgets. QToolbar

   148 for example is now a specialized subclass of a dock window.  The API

   149 of QMainWindow and QToolBar is source compatible with Qt 2.x, so

   150 existing code which uses these classes will continue to work.

   151 

   152 

   153 Regular Expressions

   154 -------------------

   155 

   156 Qt has always provided regular expression support, but that support

   157 was pretty much limited to what was required in common GUI control

   158 elements such as file dialogs. Qt 3.0 introduces a new regular

   159 expression engine that supports most of Perl's regex features and is

   160 Unicode based. The most useful additions are support for parentheses

   161 (capturing and non-capturing) and backreferences.

   162 

   163 

   164 Storing application settings

   165 ----------------------------

   166 

   167 Most programs will need to store some settings between runs, for

   168 example, user selected fonts, colors and other preferences, or a list

   169 of recently used files.  The new QSettings class provides a platform

   170 independent way to achieve this goal. The API makes it easy to store

   171 and retrieve most of the basic data types used in Qt (such as basic

   172 C++ types, strings, lists, colors, etc). The class uses the registry

   173 on the Windows platform and traditional resource files on Unix.

   174 

   175 

   176 Creating and controlling other processes

   177 ----------------------------------------

   178 

   179 QProcess is a class that allows you to start other programs from

   180 within a Qt application in a platform independent manner. It gives you

   181 full control over the started program, for example you can redirect

   182 the input and output of console applications.

   183 

   184 

   185 Accessibility (not part of the beta1 release)

   186 ---------------------------------------------

   187 

   188 Accessibility means making software usable and accessible to a wide

   189 range of users, including those with disabilities. In Qt 3.0, most

   190 widgets provide accessibility information for assistive tools that can

   191 be used by a wide range of disabled users. Qt standard widgets like

   192 buttons or range controls are fully supported. Support for complex

   193 widgets, like e.g. QListView, is in development. Existing applications

   194 that make use of standard widgets will become accessible just by using

   195 Qt 3.0.

   196 

   197 Qt uses the Active Accessibility infrastructure on Windows, and needs

   198 the MSAA SDK, which is part of most platform SDKs. With improving

   199 standardization of accessibility on other platforms, Qt will support

   200 assistive technologies on other systems, too.

   201 

   202 The accessibility API in Qt is not yet stable, which is why we decided

   203 not to make it a part of the beta1 release.

   204 

   205 

   206 XML Improvements

   207 ----------------

   208 

   209 The XML framework introduced in Qt 2.2 has been vastly improved. Qt

   210 2.2 already supported level 1 of the Document Object Model (DOM), a

   211 W3C standard for accessing and modifying XML documents.  Qt 3.0 has

   212 added support for DOM Level 2 and XML namespaces.

   213 

   214 The XML parser has been extended to allow incremental parsing of XML

   215 documents. This allows you to start parsing the document directly

   216 after the first parts of the data have arrived, and to continue

   217 whenever new data is available.  This is especially useful if the XML

   218 document is read from a slow source, e.g. over the network, as it

   219 allows the application to start working on the data at a very early

   220 stage.

   221 

   222 

   223 SVG support

   224 -----------

   225 

   226 SVG is a W3C standard for "Scalable Vector Graphics". Qt 3.0's SVG

   227 support means that QPicture can optionally generate and import static

   228 SVG documents. All the SVG features that have an equivalent in

   229 QPainter are supported.

   230 

   231 

   232 Multihead support

   233 -----------------

   234 

   235 Many professional applications, such as DTP and CAD software, are able

   236 to display data on two or more monitors. In Qt 3.0 the QDesktopWidget

   237 class provides the application with runtime information about the

   238 number and geometry of the desktops on the different monitors and such

   239 allows applications to efficiently use a multi-monitor setup.

   240 

   241 The virtual desktop of Windows 98 and 2000 is supported, as well as

   242 the traditional multi-screen and the newer Xinerama multihead setups

   243 on X11.

   244 

   245 

   246 X11 specific enhancements

   247 -------------------------

   248 

   249 Qt 3.0 now complies with the NET WM Specification, recently adopted

   250 by KDE 2.0.  This allows easy integration and proper execution with

   251 desktop environments that support the NET WM specification.

   252 

   253 The font handling on X11 has undergone major changes.  QFont no longer

   254 has a one-to-one relation with window system fonts.  QFont is now a

   255 logical font that can load multiple window system fonts to simplify

   256 Unicode text display.  This completely removes the burden of

   257 changing/setting fonts for a specific locale/language from the

   258 programmer.  For end-users, any font can be used in any locale.  For

   259 example, a user in Norway will be able to see Korean text without

   260 having to set their locale to Korean.

   261 

   262 Qt 3.0 also supports the new render extension recently added to

   263 XFree86. This adds support for anti aliased text and pixmaps with

   264 alpha channel (semi transparency) on the systems that support the

   265 rendering extension (at the moment XFree 4.0.3 and later).

   266 

   267 

   268 Printing

   269 --------

   270 

   271 Printing support has been enhanced on all platforms. The QPrinter

   272 class now supports setting a virtual resolution for the painting

   273 process. This makes WYSIWYG printing trivial, and also allows you to

   274 take full advantage of the high resolution of a printer when painting

   275 on it.

   276 

   277 The postscript driver built into Qt and used on Unix has been greatly

   278 enhanced. It supports the embedding of true/open type and type1 fonts

   279 into the document, and can correctly handle and display Unicode.

   280 Support for fonts built into the printer has been enhanced and Qt now

   281 knows about the most common printer fonts used for Asian languages.

   282 

   283 

   284 QHttp

   285 -----

   286 

   287 This class provides a simple interface for HTTP downloads and uploads.

   288 

   289 

   290 Compatibility with the Standard Template Library (STL)

   291 ------------------------------------------------------

   292 

   293 Support for the C++ Standard Template Library has been added to the Qt

   294 Template Library (QTL).  The QTL classes now contain appropriate copy

   295 constructors and typedefs so that they can be freely mixed with other

   296 STL containers and algorithms.  In addition, new member functions have

   297 been added to QTL template classes which correspond to STL-style

   298 naming conventions (e.g., push_back()).

   299 

   300 

   301 Qt Designer

   302 ========================================

   303 

   304 Qt Designer was a pure dialog editor in Qt 2.2 but has now been

   305 extended to provide the full functionality of a GUI design tool.

   306 

   307 This includes the ability to lay out main windows with menus and

   308 toolbars. Actions can be edited within Qt Designer and then plugged

   309 into toolbars and menu bars via drag and drop. Splitters can now be

   310 used in a way similar to layouts to group widgets horizontally or

   311 vertically.

   312 

   313 In Qt 2.2, many of the dialogs created by Qt Designer had to be

   314 subclassed to implement functionality beyond the predefined signal and

   315 slot connections. Whilst the subclassing approach is still fully supported,

   316 Qt Designer now offers an alternative: a plugin for editing 

   317 slots. The editor offers features such as syntax highlighting,

   318 completion, parentheses matching and incremental search.

   319 

   320 The functionality of Qt Designer can now be extended via plugins.

   321 Using Qt Designer's interface or by implementing one of the provided

   322 interfaces in a plugin, a two way communication between plugin and Qt

   323 Designer can be established. This functionality is used to implement

   324 plugins for custom widgets, so that they can be used as real widgets

   325 inside the designer.

   326 

   327 Basic support for project management has been added. This allows you

   328 to read and edit *.pro files, add and remove files to/from the project

   329 and do some global operations on the project. You can now open the

   330 project file and have one-click access to all the *.ui forms in the

   331 project.

   332 

   333 In addition to generating code via uic, Qt Designer now supports the

   334 dynamic creation of widgets directly from XML user interface

   335 description files (*.ui files) at runtime. This eliminates the need of

   336 recompiling your application when the GUI changes, and could be used

   337 to enable your customers to do their own customizations. Technically,

   338 the feature is provided by a new class, QWidgetFactory in the

   339 QResource library.

   340 

   341 

   342 Qt Linguist

   343 ========================================

   344 

   345 Qt Linguist is a GUI utility to support translating the user-visible

   346 text in applications written with Qt. It comes with two command-line

   347 tools: lupdate and lrelease.

   348 

   349 Translation of a Qt application is a three-step process:

   350 

   351   1) Run lupdate to extract user-visible text from the C++ source

   352      code of the Qt application, resulting in a translation source file

   353      (a *.ts file).

   354   2) Provide translations for the source texts in the *.ts file using

   355      Qt Linguist.

   356   3) Run lrelease to obtain a light-weight message file (a *.qm file)

   357      from the *.ts file, which provides very fast lookup for released

   358      applications.

   359 

   360 Qt Linguist is a tool suitable for use by translators. Each

   361 user-visible (source) text is characterized by the text itself, a

   362 context (usually the name of the C++ class containing the text), and

   363 an optional comment to help the translator. The C++ class name will

   364 usually be the name of the relevant dialog, and the comment will often

   365 contain instructions that describe how to navigate to the relevant

   366 dialog.

   367 

   368 You can create phrase books for Qt Linguist to provide common

   369 translations to help ensure consistency and to speed up the

   370 translation process. Whenever a translator navigates to a new text to

   371 translate, Qt Linguist uses an intelligent algorithm to provide a list

   372 of possible translations: the list is composed of relevant text from

   373 any open phrase books and also from identical or similar text that has

   374 already been translated.

   375 

   376 Once a translation is complete it can be marked as "done"; such

   377 translations are included in the *.qm file. Text that has not been

   378 "done" is included in the *.qm file in its original form. Although Qt

   379 Linguist is a GUI application with dock windows and mouse control,

   380 toolbars, etc., it has a full set of keyboard shortcuts to make

   381 translation as fast and efficient as possible.

   382 

   383 When the Qt application that you're developing evolves (e.g. from

   384 version 1.0 to version 1.1), the utility lupdate merges the source

   385 texts from the new version with the previous translation source file,

   386 reusing existing translations. In some typical cases, lupdate may

   387 suggest translations. These translations are marked as unfinished, so

   388 you can easily find and check them.

   389 

   390 

   391 Qt Assistant

   392 ========================================

   393 

   394 Due to the positive feedback we received about the help system built

   395 into Qt Designer, we decided to offer this part as a separate

   396 application called Qt Assistant. Qt Assistant can be used to browse

   397 the Qt class documentation as well as the manuals for Qt Designer and

   398 Qt Linguist. It offers index searching, a contents overview, bookmarks

   399 history and incremental search. Qt Assistant is used by both Qt

   400 Designer and Qt Linguist for browsing their help documentation.

   401 

   402 

   403 QMake

   404 ========================================

   405 

   406 To ease portability we now provide the qmake utility to replace tmake.

   407 QMake is a C++ version of tmake which offers additional functionallity

   408 that is difficult to reproduce in tmake. Qt uses qmake in its

   409 build system and we have released it as free software.

   410 

   411 

   412 Qt Functions

   413 ========================================

   414 

   415 QAction

   416 -------

   417 

   418 All new functions:

   419 	void addedTo( QWidget *actionWidget, QWidget *container );

   420 	void addedTo( int index, QPopupMenu *menu );

   421 

   422 QActionGroup

   423 ------------

   424 

   425 New mode "uses drop down", where members are shown in a separate

   426 subwidget such as a combobox or a submenu (enable with

   427 setUsesDropDown(TRUE) )

   428 

   429 All new functions:

   430 	void add(QAction*);

   431 	void addSeparator();

   432 	void addedTo( QWidget *actionWidget, QWidget *container, QAction *a );

   433 	void addedTo( int index, QPopupMenu *menu, QAction *a );

   434 	void setUsesDropDown( bool enable );

   435 	bool usesDropDown() const;

   436 

   437 

   438 QApplication

   439 ------------

   440 

   441 Added the setStyle(const QString&) overload that takes the name of the

   442 style as its argument. This loads a style plugin via a QStyleFactory.

   443 

   444 desktop() now returns a QDesktopWidget that provides access to

   445 multi-head information. Prior to 3.0, it returned a normal QWidget.

   446 

   447 New functions to define the library search path for plugins

   448 (setLibraryPaths, ...).

   449 

   450 New functions to define reverse layout for bidirectional languages

   451 (setReverseLayout, ...).

   452 

   453 All new functions:

   454 	bool hasPendingEvents()

   455 

   456 	void setLibraryPaths(const QStringList &);

   457 	QStringList libraryPaths();

   458 	void addLibraryPath(const QString &);

   459 	void removeLibraryPath(const QString &);

   460 

   461 	void setReverseLayout( bool b );

   462 	bool reverseLayout();

   463 	int horizontalAlignment( int align );

   464 

   465 

   466 

   467 QClipboard

   468 ----------

   469 

   470 On systems that support it, for example X11, QClipboard now

   471 differentiates between the primary selection and the data in the clipboard.

   472 

   473 All new functions:

   474 	bool supportsSelection() const;

   475 	bool ownsClipboard() const;

   476 	void setSelectionMode(bool enable);

   477 	bool selectionModeEnabled() const;

   478 New signals:

   479 	void selectionChanged()

   480 	

   481 

   482 

   483 QCursor

   484 -------

   485 

   486 Now inherits Qt namespace. Enum values like ArrowCursor,

   487 UpArrowCursor, CrossCursor etc. are now part of that namespace.

   488 

   489 

   490 QDataStream

   491 -----------

   492 

   493 Added missing operators for Q_LONG and Q_ULONG

   494 

   495 

   496 QDateTime / QDate / QTime

   497 -------------------------

   498 

   499 More sophisticated toString() function that takes a DateFormat, where

   500 DateFormat can be either TextDate (the default), ISODate (ISO 8601) or

   501 LocalDate (locale dependent).

   502 

   503 All new functions:

   504 	QDate addMonths( int months ) const;

   505 	QDate addYears( int years ) const;

   506 	QDate fromString( const QString& s, Qt::DateFormat f = Qt::TextDate );

   507 	static QString shortMonthName( int month );

   508 	static QString longMonthName( int month );

   509 	static QString shortDayName( int weekday );

   510 	static QString longDayName( int weekday );

   511 	static void setShortMonthNames( const QStringList& names );

   512 	static void setLongMonthNames( const QStringList& names );

   513 	static void setShortDayNames( const QStringList& names );

   514 	static void setLongDayNames( const QStringList& names );

   515 

   516 QDialog

   517 -------

   518 

   519 Merged with QSemiModal. Calling show() on a modal dialog will return

   520 immediately, not enter a local event loop. Showing a modal dialog in

   521 its own event loop is achieved using exec().

   522 

   523 exec() is now a public slot.

   524 

   525 Usability: For widgets supporting What's This help, QDialog

   526 automatically offers a context menu containing a "What's This?" entry.

   527 

   528 

   529 QEvent

   530 ------

   531 

   532 Mouse events are now propagated up to the toplevel widget if no widget

   533 accepts them and no event filter filters them out. In previous Qt

   534 versions, only key events were propagated.

   535 

   536 All events carry a flag 'spontaneous' to determine whether the even

   537 came from the outside or was generated by code within the

   538 applications. Previously, only show and hide events had this flag.

   539 

   540 Enter/Leave event generation has been fixed. Previously, a widget

   541 received a leave event when the mouse pointer entered one of its

   542 children. This was both unnatural and contradictive to the

   543 documentation.

   544 

   545 QWheelevent now carries an orientation to differentiate between

   546 horizontal and vertical wheels.

   547 

   548 QFocusEvent: new reason 'Backtab' (previously only 'Tab' was

   549 available). This makes it possible to discover from what direction on

   550 the tab-focus chain the widget was entered.

   551 

   552 New events: QContextMenuEvent, QIMEvent

   553 

   554 

   555 QFile

   556 -----

   557 

   558 Ported from int to Q_LONG to prepare for large file sizes on 64 bit

   559 systems.

   560 

   561 Filter handling made more flexible.

   562 

   563 

   564 QFileDialog

   565 -----------

   566 

   567 All new Functions:

   568 	void setSelectedFilter( const QString& );

   569 	void setSelectedFilter( int );

   570 New signals:

   571 	void filesSelected( const QStringList& );

   572 	void filterSelected( const QString& );

   573 

   574 If you try to specify an invalid file when using getOpenFileName(s), an error message

   575 will appear and the file will not be accepted.  In 2.x, this function behaved differently

   576 because users were using getOpenFileName(s) as a Save File Dialog; you should use

   577 getSaveFileName() when you require a Save File Dialog.	

   578 

   579 

   580 QCanvas Module

   581 --------------

   582 

   583 	New classes:

   584 		QCanvasSpline - a multi-bezier spline

   585 

   586 	QCanvasItemList

   587 		void update();

   588 

   589 	QCanvas:

   590 		QRect rect() const;

   591 		void setUnchanged( const QRect& area );

   592 		void drawArea(const QRect&, QPainter* p, bool double_buffer);

   593 		void drawViewArea( QCanvasView* view, QPainter* p, const QRect& r, bool dbuf );

   594 		QRect changeBounds(const QRect& inarea);

   595 

   596 	QCanvasView:

   597 		const QWMatrix &worldMatrix() const;

   598 		const QWMatrix &inverseWorldMatrix() const;

   599 		void setWorldMatrix( const QWMatrix & );

   600 	QCanvasSprite:

   601 		int leftEdge() const;

   602 		int topEdge() const;

   603 		int rightEdge() const;

   604 		int bottomEdge() const;

   605 		int leftEdge(int nx) const;

   606 		int topEdge(int ny) const;

   607 		int rightEdge(int nx) const;

   608 		int bottomEdge(int ny) const;

   609 

   610 QCanvasSprite can now be set to animate its frames without the need to

   611 subclass.

   612 

   613 

   614 QFont, QFontDatabase, QFontInfo, QFontMetrics

   615 ---------------------------------------------

   616 

   617 The QFont::CharSet enum has been removed and replaced with the

   618 QFont::Script enum. With this change, a QFont is not associated with a

   619 specific character set. Instead, QFont uses Unicode Scripts for

   620 loading fonts.  On platforms where most fonts do not use the Unicode

   621 encoding (currently only X11), multiple locale and character-set

   622 dependent fonts can be loaded for the individual Unicode Scripts.

   623 

   624 Another new feature of QFont is a much more flexible substitution

   625 mechanism. Each family can have a list of appropriate substitutes. The

   626 font substitution feature allows you to specify a list of substitute

   627 fonts. Substitute fonts are used when a font cannot be loaded, or if

   628 the specified font doesn't have a particular character (X11 only).

   629 

   630 For example (on X11), you select the font Lucida, which doesn't have

   631 Korean characters. For Korean text, you want to use the Mincho font

   632 family. By adding Mincho to the list, any Korean characters not found

   633 in Lucida will be used from Mincho. Because the font substitutions are

   634 lists, you can also select multiple families, such as Song Ti (for use

   635 with Chinese text).

   636 

   637 QFontInfo and QFontMetrics had small API changes related to the

   638 disappearance of QFont::CharSet.  In terms of functionality, the

   639 behavior of these classes is unchanged.

   640 

   641 QFontDatabase had several API cleanups related to the disappearance of

   642 QFont::CharSet.  Most QFontDatabase member functions take one less

   643 argument, yet compatibility functions still exist to keep old source

   644 code working.

   645 

   646 Family and style names returned from QFontDatabase are now processed

   647 and formatted in a way that is suitable for display to users.  Family

   648 and foundry names are capitalized and foundry names are enclosed in

   649 square brackets after the family name.  For example, the Helvetica

   650 font family might have 3 different foundries: Adobe, Cronyx and

   651 Phaisarn. In 2.x, QFontDatabase listed them like this:

   652 

   653 	adobe-helvetica

   654 	cronyx-helvetica

   655 	phaisarn-helvetica

   656 

   657 Starting with 3.0, QFontDatabase lists them like this:

   658 

   659 	Helvetica [Adobe]

   660 	Helvetica [Cronyx]

   661 	Helvetica [Phaisarn]

   662 

   663 

   664 QFrame

   665 ------

   666 

   667 Two new frame shapes for more sophisticated style features:

   668 MenuBarPanel and ToolBarPanel.

   669 

   670 

   671 QGrid

   672 -----

   673 

   674 The member type

   675 

   676     enum Direction { Horizontal, Vertical };

   677 

   678 has been eliminated, as it is redundant: use Qt::Orientation instead.

   679 Old code referring to QGrid::Horizontal or QGrid::Vertical will still

   680 work, as QGrid counts Qt among its ancestors.

   681 

   682 

   683 QGroupBox

   684 ---------

   685 

   686 More functionality of the built-in layout is exposed:

   687 

   688 	int insideMargin() const;

   689 	int insideSpacing() const;

   690 	void setInsideMargin( int m );

   691 	void setInsideSpacing( int s );

   692 

   693 

   694 QHeader

   695 -------

   696 

   697 New property: bool stretching

   698 

   699 New functions:

   700 	bool isStretchEnabled( int section );

   701 	void setStretchEnabled( bool b, int section );

   702 	

   703 

   704 QIconSet

   705 --------

   706 

   707 In addition to the mode - which can be either Normal, Disabled or

   708 Active - QIconSet now supports different pixmaps for a state, i.e. On

   709 or Off. The functions pixmap() and setPixmap() have been extended

   710 accordingly.

   711 

   712 The default constructor no longer initializes the iconset to

   713 contain a null pixmap. QIconSet::isNull() returns TRUE for un-

   714 initialized iconsets, and pixmap() still returns a null pixmap for

   715 pixmaps that couldn't be generated.

   716 

   717 

   718 QIconView

   719 ---------

   720 

   721 Extended findItem() to support ComparisonFlags. Support for

   722 soft-hyphens when doing word wrap.

   723 

   724 New signal:

   725 	contextMenuRequested( QIconViewItem*, const QPoint& pos);

   726 

   727 

   728 QIconViewItem

   729 -------------

   730 

   731 Added support for explicit rtti.

   732 

   733 New function:

   734 	int rtti() const;

   735 

   736 

   737 

   738 QListBox

   739 --------

   740 

   741 Extended findItem() to support ComparisonFlags.

   742 

   743 New signal:

   744 	void contextMenu( QListBoxItem *, const QPoint & );

   745 

   746 

   747 QListBoxItem

   748 ------------

   749 

   750 Added support for explicit rtti.

   751 

   752 New function:

   753 	int rtti() const;

   754 

   755 

   756 

   757 QListView

   758 ---------

   759 

   760 It was never really hard to implement drag and drop with QListView,

   761 but since many applications demand this functionality today, we

   762 decided to add it to the listview itself.

   763 

   764 In addition, in-place editing and per-item tooltips have been added.

   765 Extended findItem() to support ComparisonFlags

   766 

   767 New properties:

   768 	bool showToolTips

   769 	ResizeMode resizeMode

   770 

   771 New signals:

   772 	contextMenuRequested( QIconViewItem*, const QPoint& pos);

   773 	void dropped( QDropEvent *e );

   774 	void itemRenamed( QListViewItem *item, int col, const QString & );

   775 	void itemRenamed( QListViewItem *item, int col  );

   776 

   777 New functions:

   778 	void setResizeMode( ResizeMode m );

   779 	ResizeMode resizeMode() const;

   780 	QDragObject *dragObject();

   781 	void startDrag();

   782 	void startRename();

   783 

   784 

   785 QListViewItem

   786 -------------

   787 

   788 Added support for explicit rtti.

   789 

   790 New functions:

   791 	void setDragEnabled( bool allow );

   792 	void setDropEnabled( bool allow );

   793 	bool dragEnabled() const;

   794 	bool dropEnabled() const;

   795 	bool acceptDrop( const QMimeSource *mime ) const;

   796 	void setVisible( bool b );

   797 	bool isVisible() const;

   798 	void setRenameEnabled( int col, bool b );

   799 	bool renameEnabled( int col ) const;

   800 	void startRename( int col );

   801 	void setEnabled( bool b );

   802 	bool isEnabled() const;

   803 	int rtti() const;

   804 

   805 	void dropped( QDropEvent *e );

   806 	void dragEntered();

   807 	void dragLeft();

   808 	void okRename( int col );

   809 	void cancelRename( int col );

   810 

   811 

   812 QLabel

   813 ------

   814 

   815 In addition to text, rich text, pixmaps and movies, QLabel can now

   816 display QPicture vector graphics.

   817 

   818 New functions:

   819 

   820 	QPicture *picture() const;

   821 	void setPicture( const QPicture & );

   822 

   823 

   824 QLineEdit

   825 ---------

   826 

   827 New property: bool dragEnabled

   828 

   829 New signal:

   830 	contextMenuRequested( QIconViewItem*, const QPoint& pos);

   831 

   832 New functions:

   833 	void cursorForward( bool mark, int steps = 1 );

   834 	void cursorBackward( bool mark, int steps = 1 );

   835 	void cursorWordForward( bool mark );

   836 	void cursorWordBackward( bool mark );

   837 	bool dragEnabled();

   838 	void setDragEnabled( bool b );

   839 

   840 

   841 QMainWindow

   842 -----------

   843 

   844 Added a dock window architecture. Previous versions of QMainWindow

   845 could only deal with toolbars, now they handle generalized dock

   846 windows. QToolBar inherits QDockWindow.

   847 

   848 

   849 New property:

   850 	bool dockWindowsMovable;

   851 

   852 New signals:

   853 	void dockWindowPositionChanged( QDockWindow * );

   854 

   855 New functions:

   856 	void setDockEnabled( Dock dock, bool enable );

   857 	bool isDockEnabled( Dock dock ) const;

   858 	bool isDockEnabled( QDockArea *area ) const;

   859 	void setDockEnabled( QDockWindow *tb, Dock dock, bool enable );

   860 	bool isDockEnabled( QDockWindow *tb, Dock dock ) const;

   861 	bool isDockEnabled( QDockWindow *tb, QDockArea *area ) const;

   862 

   863 	void addDockWindow( QDockWindow *, Dock = Top, bool newLine = FALSE );

   864 	void addDockWindow( QDockWindow *, const QString &label, Dock = Top, bool newLine = FALSE );

   865 	void moveDockWindow( QDockWindow *, Dock = Top );

   866 	void moveDockWindow( QDockWindow *, Dock, bool nl, int index, int extraOffset = -1 );

   867 	void removeDockWindow( QDockWindow * );

   868 

   869 	QDockArea *dockingArea( const QPoint &p );

   870 	QDockArea *leftDock() const;

   871 	QDockArea *rightDock() const;

   872 	QDockArea *topDock() const;

   873 	QDockArea *bottomDock() const;

   874 	

   875 	bool isCustomizable() const;

   876 	bool appropriate( QDockWindow *dw ) const;

   877 	QPopupMenu *createDockWindowMenu( DockWindows dockWindows = AllDockWindows ) const;

   878 

   879 	bool showDockMenu( const QPoint &globalPos );

   880 

   881 

   882 QMetaObject

   883 -----------

   884 

   885 ###TODO

   886 

   887 

   888 QMimeSourceFactory

   889 ------------------

   890 

   891 New static functions:

   892 	QMimeSourceFactory* takeDefaultFactory();

   893 	static void addFactory( QMimeSourceFactory *f );

   894 

   895 

   896 QNetworkProtocol

   897 ----------------

   898 

   899 Spelling fix in Error::ErrListChildren enum.

   900 

   901 

   902 QRegExp

   903 -------

   904 

   905 QRegExp now has a more complete regular expression engine similar to

   906 Perl's, with full Unicode and backreference support.

   907 

   908 New functions:

   909 	bool minimal() const;

   910 	void setMinimal( bool minimal );

   911 	bool exactMatch( const QString& str );

   912 	bool exactMatch( const QString& str ) const;

   913 	int search( const QString& str, int start = 0 );

   914 	int search( const QString& str, int start = 0 ) const;

   915 	int searchRev( const QString& str, int start = -1 );

   916 	int searchRev( const QString& str, int start = -1 ) const;

   917 	int matchedLength();

   918 	QStringList capturedTexts();

   919 	QString cap( int nth = 0 );

   920 	int pos( int nth = 0 );

   921 

   922 

   923 QSessionManager

   924 ---------------

   925 

   926 Renamed the misnamed setProperty() overloads to setManagerProperty()

   927 to resolve the conflict with the now virtual QObject::setProperty().

   928 

   929 

   930 QString

   931 -------

   932 

   933 New functions:

   934 	bool endsWith( const QString & );

   935 	int similarityWith( const QString & );

   936 

   937 ### TODO

   938 

   939 QStyle

   940 ------

   941 

   942 ### TODO

   943 

   944 QTabBar

   945 -------

   946 

   947 The extended QTabWidget support in Qt Designer made two more

   948 functions handy to have:

   949 	QTab * tabAt( int ) const;

   950 	int indexOf( int ) const;

   951 

   952 

   953 

   954 QToolBar

   955 --------

   956 

   957 Inherits QDockWindow now, previously only QWidget.

   958 

   959 

   960 QToolButton

   961 -----------

   962 

   963 New property:

   964 	QIconSet iconSet

   965 

   966 New functions:

   967 	QIconSet iconSet() const;

   968 	virtual void setIconSet( const QIconSet & );

   969 

   970 QWidget

   971 -------

   972 

   973 New functions:

   974 

   975     const QColor & eraseColor() const;

   976     virtual void setEraseColor( const QColor & );

   977     const QPixmap * erasePixmap() const;

   978     virtual void setErasePixmap( const QPixmap & );

   979 

   980 

   981 

   982 QWizard

   983 -------

   984 

   985 New property: QString titleFont

   986 

   987 New functions:

   988 	QFont titleFont() const;

   989 	void setTitleFont( const QFont & );

   990 	int indexOf( QWidget* ) const;

   991 

   992 

   993 QWMatrix

   994 --------

   995 

   996 New function:

   997 	bool isIdentity() const;

   998 	

   999 

  1000 QGL Module

  1001 ----------

  1002 

  1003 QGLWidget

  1004 New functions:

  1005 	QGLFormat requestedFormat() const;

  1006 	QImage grabFrameBuffer( bool withAlpha = FALSE );

  1007 

  1008 

  1009 QWorkspace Module

  1010 -----------------

  1011 

  1012 A new property scrollBarsEnabled makes it possible to add on-demand

  1013 scrollbars to the workspace. We define this property in Qt Designer to

  1014 make designing forms larger than the available space on the desktop

  1015 more comfortable.

  1016 

  1017 New property:

  1018 	bool scrollBarsEnabled

  1019 

  1020 

  1021 QXML Module

  1022 -----------

  1023 Many new functions have been added:

  1024 	QDomImplementation

  1025 		QDomDocumentType createDocumentType( const QString& qName, const QString& publicId, const QString& systemId );

  1026 		QDomDocument createDocument( const QString& nsURI, const QString& qName, const QDomDocumentType& doctype );

  1027 	QDomNode

  1028 		QDomNode insertBefore( const QDomNode& newChild, const QDomNode& refChild );

  1029 		QDomNode insertAfter( const QDomNode& newChild, const QDomNode& refChild );

  1030 		QDomNode replaceChild( const QDomNode& newChild, const QDomNode& oldChild );

  1031 		QDomNode removeChild( const QDomNode& oldChild );

  1032 		QDomNode appendChild( const QDomNode& newChild );

  1033 		bool hasChildNodes() const;

  1034 		QDomNode cloneNode( bool deep = TRUE ) const;

  1035 		void normalize();

  1036 		bool isSupported( const QString& feature, const QString& version ) const;

  1037 		QString namespaceURI() const;

  1038 		QString localName() const;

  1039 		bool hasAttributes() const;

  1040 	QDomDocument

  1041 		bool setContent( const QCString& text, bool namespaceProcessing=FALSE );

  1042 		bool setContent( const QByteArray& text, bool namespaceProcessing=FALSE );

  1043 		bool setContent( const QString& text, bool namespaceProcessing=FALSE );

  1044 		bool setContent( QIODevice* dev, bool namespaceProcessing=FALSE );

  1045 	QDomNamedNodeMap

  1046 		QDomNode namedItemNS( const QString& nsURI, const QString& localName ) const;

  1047 		QDomNode setNamedItemNS( const QDomNode& newNode );

  1048 		QDomNode removeNamedItemNS( const QString& nsURI, const QString& localName );

  1049 

  1050 	QDomElement

  1051 		QString attributeNS( const QString nsURI, const QString& localName, const QString& defValue ) const;

  1052 		void setAttributeNS( const QString nsURI, const QString& qName, const QString& value );

  1053 		void setAttributeNS( const QString nsURI, const QString& qName, int value );

  1054 		void setAttributeNS( const QString nsURI, const QString& qName, uint value );

  1055 		void setAttributeNS( const QString nsURI, const QString& qName, double value );

  1056 		void removeAttributeNS( const QString& nsURI, const QString& localName );

  1057 		QDomAttr attributeNodeNS( const QString& nsURI, const QString& localName );

  1058 		QDomAttr setAttributeNodeNS( const QDomAttr& newAttr );

  1059 		QDomNodeList elementsByTagNameNS( const QString& nsURI, const QString& localName ) const;

  1060 		bool hasAttributeNS( const QString& nsURI, const QString& localName ) const;

  1061 

  1062 	

  1063 	QXmlAttributes

  1064 		void clear();

  1065 		void append( const QString &qName, const QString &uri, const QString &localPart, const QString &value );

  1066 

  1067 	QXmlInputSource:

  1068 		void setData( const QByteArray& dat );

  1069 		void fetchData();

  1070 		QString data();

  1071 		QChar next();

  1072 		void reset();

  1073 		QString fromRawData( const QByteArray &data, bool beginning = FALSE );

  1074 

  1075 	QXmlSimpleReader:

  1076 		bool parse( const QXmlInputSource& input, bool incremental );

  1077 		bool parseContinue();

  1078 

  1079 	QXmlEntityResolver:

  1080 		bool startEntity( const QString& name );

  1081 		bool endEntity( const QString& name );

  1082 

  1083 	

  1084 

  1085 New classes

  1086 -----------

  1087 

  1088 QAquaStyle (only on MacOS X)

  1089 QCleanupHandler

  1090 QComponentFactory

  1091 QComponentFactoryInterface

  1092 QComponentServerInterface

  1093 QContextMenuEvent

  1094 QDesktopWidget

  1095 QDockArea

  1096 QDockWindow

  1097 QErrorMessage

  1098 QFeatureListInterface

  1099 QHttp [network]

  1100 QInterfaceListInterface

  1101 QInterfacePtr

  1102 QIMEvent

  1103 QLibrary

  1104 QLibraryInterface

  1105 QStyleFactory

  1106 QStyleInterface

  1107 QTextCodecInterface

  1108 QUnknownInterface

  1109 QUuid

  1110 QRegExpValidator

  1111 QTextEdit

  1112 

  1113 

  1114 Renamed Classes

  1115 ---------------

  1116 

  1117 QArray has been renamed QMemArray

  1118 QCollection has been renamed QPtrCollection

  1119 QList has been renamed QPtrList

  1120 QListIterator has been renamed QPtrListIterator

  1121 QQueue has been renamed QPtrQueue

  1122 QStack has been renamed QPtrStack

  1123 QVector has been renamed QPtrVector

  1124 

  1125 The include file names have changed accordingly (e.g., <qmemarray.h>).

  1126 

  1127 

  1128 New Modules

  1129 -----------

  1130 

  1131 SQL

  1132 	QDataBrowser

  1133 	QDataTable

  1134 	QDataView

  1135 	QDateTimeEdit