/**************************************************************************** ** ** Change documentation ** ** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved. ** ** This file is part of the TQt GUI Toolkit. ** ** This file may be used under the terms of the GNU General ** Public License versions 2.0 or 3.0 as published by the Free ** Software Foundation and appearing in the files LICENSE.GPL2 ** and LICENSE.GPL3 included in the packaging of this file. ** Alternatively you may (at your option) use any later version ** of the GNU General Public License if such license has been ** publicly approved by Trolltech ASA (or its successors, if any) ** and the KDE Free TQt Foundation. ** ** Please review the following information to ensure GNU General ** Public Licensing requirements will be met: ** http://trolltech.com/products/qt/licenses/licensing/opensource/. ** If you are unsure which license is appropriate for your use, please ** review the following information: ** http://trolltech.com/products/qt/licenses/licensing/licensingoverview ** or contact the sales department at sales@trolltech.com. ** ** This file may be used under the terms of the Q Public License as ** defined by Trolltech ASA and appearing in the file LICENSE.QPL ** included in the packaging of this file. Licensees holding valid Qt ** Commercial licenses may use this file in accordance with the Qt ** Commercial License Agreement provided with the Software. ** ** This file is provided "AS IS" with NO WARRANTY OF ANY KIND, ** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR ** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted ** herein. ** **********************************************************************/ /*! \page keyfeatures30.html \title Key Features in TQt 3.0 Qt 3.0 adds a lot of new features and improvements over the TQt 2.x series. Some internals have undergone major redesign and new classes and methods have been added. We have tried to keep the API of TQt 3.0 as compatible as possible with the TQt 2.x series. For most applications only minor changes will be needed to compile and run them successfully using TQt 3.0. One of the major new features that has been added in the 3.0 release is a module allowing you to easily work with databases. The API is platform independent and database neutral. This module is seamlessly integrated into TQt Designer, greatly simplifying the process of building database applications and using data aware widgets. \omit Other major new features include a component architecture allowing you to build cross platform components, 'plugins' with Qt. \endomit Other major new features include a plugin architecture. You can use your own and third party plugins your own applications. The Unicode support of TQt 2.x has been greatly enhanced, it now includes full support for scripts written from right to left (e.g. Arabic and Hebrew) and also provides improved support for Asian languages. Many new classes have been added to the TQt Library. Amongst them are classes that provide a docking architecture (\l{TQDockArea}/\l{TQDockWindow}), a powerful rich text editor (TQTextEdit), a class to store and access application settings (TQSettings) and a class to create and communicate with processes (TQProcess). Apart from the changes in the library itself a lot has been done to make the development of TQt applications with TQt 3.0 even easier than before. Two new applications have been added: TQt Linguist is a tool to help you translate your application into different languages; Qt Assistant is an easy to use help browser for the TQt documentation that supports bookmarks and can search by keyword. Another change concerns the TQt build system, which has been reworked to make it a lot easier to port TQt to new platforms. You can use this platform independent build system for your own applications. \section1 The TQt Library A large number of new features has been added to TQt 3.0. The following list gives an overview of the most important new and changed aspects of the TQt library. A full list of every new method follows the overview. \section2 Database support One of the major new features in TQt 3.0 is the \link sql.html SQL module\endlink that provides multiplatform access to SQL databases, making database application programming with TQt seamless and portable. The API, built with standard SQL, is database-neutral and software development is independent of the underlying database. A collection of tightly focused C++ classes are provided to give the programmer direct access to SQL databases. Developers can send raw SQL to the database server or have the TQt SQL classes generate SQL queries automatically. Drivers for Oracle, PostgreSQL, MySQL and ODBC are available and writing new drivers is straightforward. Tying the results of SQL queries to GUI components is fully supported by Qt's SQL widgets. These classes include a tabular data widget (for spreadsheet-like data presentation with in-place editing), a form-based data browser (which provides data navigation and edit functions) and a form-based data viewer (which provides read-only forms). This framework can be extended by using custom field editors, allowing for example, a data table to use custom widgets for in-place editing. The SQL module fully supports Qt's signal/slots mechanism, making it easy for developers to include their own data validation and auditing code. Qt Designer fully supports Qt's SQL module. All SQL widgets can be laid out within TQt Designer, and relationships can be established between controls visually. Many interactions can be defined purely in terms of Qt's signals/slots mechanism directly in TQt Designer. \omit \section2 Component model - plugins The TQLibrary class provides a platform independent wrapper for runtime loading of shared libraries. Access to the shared libraries uses a COM-like interface. TQPluginManager makes it trivial to implement plugin support in applications. The TQt library is able to load additional styles, database drivers and text codecs from plugins which implement the relevant interfaces, e.g. TQStyleFactoryInterface, TQSqlDriverInterface or TQTextCodecInterface. It is possible to remove unused components from the TQt library, and easy to extend any application with 3rd party styles, database drivers or text codecs. Qt Designer supports custom widgets in plugins, and will use the widgets both when designing and previewing forms. TQComponentFactory makes it easy to register any kind of component in a global database (e.g. the Windows Registry) and to use any registered component. \endomit \section2 Plugins The TQLibrary class provides a platform independent wrapper for runtime loading of shared libraries. TQPluginManager makes it trivial to implement plugin support in applications. The TQt library is able to load additional styles, database drivers and text codecs from plugins. Qt Designer supports custom widgets in plugins, and will use the widgets both when designing and previewing forms. See the \link plugins-howto.html plugins documentation\endlink. \section2 Rich text engine and editor The rich text engine originally introduced in TQt 2.0 has been further optimized and extended to support editing. It allows editing formatted text with different fonts, colors, paragraph styles, tables and images. The editor supports different word wrap modes, command-based undo/redo, multiple selections, drag and drop, and many other features. The new TQTextEdit engine is highly optimized for proccesing and displaying large documents quickly and efficiently. \section2 Unicode Apart from the rich text engine, another new feature of TQt 3.0 that relates to text handling is the greatly improved Unicode support. Qt 3.0 includes an implementation of the bidirectional algorithm (BiDi) as defined in the Unicode standard and a shaping engine for Arabic, which gives full native language support to Arabic and Hebrew speaking people. At the same time the support for Asian languages has been greatly enhanced. The support is almost transparent for the developer using TQt to develop their applications. This means that developers who developed applications using TQt 2.x will automatically gain the full support for these languages when switching to TQt 3.0. Developers can rely on their application to work for people using writing systems different from Latin1, without having to worry about the complexities involved with these scripts, as TQt takes care of this automatically. \section2 Docked and Floating Windows Qt 3.0 introduces the concept of Dock Windows and Dock Areas. Dock windows are widgets, that can be attached to, and detached from, dock areas. The commonest kind of dock window is a tool bar. Any number of dock windows may be placed in a dock area. A main window can have dock areas, for example, TQMainWindow provides four dock areas (top, left, bottom, right) by default. The user can freely move dock windows and place them at a convenient place in a dock area, or drag them out of the application and have them float freely as top level windows in their own right. Dock windows can also be minimized or hidden. For developers, dock windows behave just like ordinary widgets. TQToolbar for example is now a specialized subclass of a dock window. The API of TQMainWindow and TQToolBar is source compatible with TQt 2.x, so existing code which uses these classes will continue to work. \section2 Regular Expressions Qt has always provided regular expression support, but that support was pretty much limited to what was required in common GUI control elements such as file dialogs. TQt 3.0 introduces a new regular expression engine, TQRegExp, that supports most of Perl's regex features and is Unicode based. The most useful additions are support for parentheses (capturing and non-capturing) and backreferences. \section2 Storing application settings Most programs will need to store some settings between runs, for example, user selected fonts, colors and other preferences, or a list of recently used files. The new TQSettings class provides a platform independent way to achieve this goal. The API makes it easy to store and retrieve most of the basic data types used in TQt (such as basic C++ types, strings, lists, colors, etc). The class uses the registry on the Windows platform and traditional resource files on Unix. \section2 Creating and controlling other processes TQProcess is a class that allows you to start other programs from within a TQt application in a platform independent manner. It gives you full control over the started program, for example you can redirect the input and output of console applications. \section2 Accessibility Accessibility means making software usable and accessible to a wide range of users, including those with disabilities. In TQt 3.0, most widgets provide accessibility information for assistive tools that can be used by a wide range of disabled users. TQt standard widgets like buttons or range controls are fully supported. Support for complex widgets, like e.g. TQListView, is in development. Existing applications that make use of standard widgets will become accessible just by using Qt 3.0. Qt uses the Active Accessibility infrastructure on Windows, and needs the MSAA SDK, which is part of most platform SDKs. With improving standardization of accessibility on other platforms, TQt will support assistive technologies on other systems, too. \section2 XML Improvements The XML framework introduced in TQt 2.2 has been vastly improved. Qt 2.2 already supported level 1 of the Document Object Model (DOM), a W3C standard for accessing and modifying XML documents. TQt 3.0 has added support for DOM Level 2 and XML namespaces. The XML parser has been extended to allow incremental parsing of XML documents. This allows you to start parsing the document directly after the first parts of the data have arrived, and to continue whenever new data is available. This is especially useful if the XML document is read from a slow source, e.g. over the network, as it allows the application to start working on the data at a very early stage. \section2 SVG support SVG is a W3C standard for "Scalable Vector Graphics". TQt 3.0's XML support means that TQPicture can optionally generate and import static SVG documents. All the SVG features that have an equivalent in TQPainter are supported. \section2 Multihead support Many professional applications, such as DTP and CAD software, are able to display data on two or more monitors. In TQt 3.0 the TQDesktopWidget class provides the application with runtime information about the number and geometry of the desktops on the different monitors and such allows applications to efficiently use a multi-monitor setup. The virtual desktop of Mac OS X, Windows 98, and 2000 is supported, as well as the traditional multi-screen and the newer Xinerama multihead setups on X11. \section2 X11 specific enhancements Qt 3.0 now complies with the NET WM Specification, recently adopted by KDE 2.0. This allows easy integration and proper execution with desktop environments that support the NET WM specification. The font handling on X11 has undergone major changes. TQFont no longer has a one-to-one relation with window system fonts. TQFont is now a logical font that can load multiple window system fonts to simplify Unicode text display. This completely removes the burden of changing/setting fonts for a specific locale/language from the programmer. For end-users, any font can be used in any locale. For example, a user in Norway will be able to see Korean text without having to set their locale to Korean. Qt 3.0 also supports the new render extension recently added to XFree86. This adds support for anti aliased text and pixmaps with alpha channel (semi transparency) on the systems that support the rendering extension (at the moment XFree 4.0.3 and later). \section2 Printing Printing support has been enhanced on all platforms. The TQPrinter class now supports setting a virtual resolution for the painting process. This makes WYSIWYG printing trivial, and also allows you to take full advantage of the high resolution of a printer when painting on it. The postscript driver built into TQt and used on Unix has been greatly enhanced. It supports the embedding of true/open type and type1 fonts into the document, and can correctly handle and display Unicode. Support for fonts built into the printer has been enhanced and TQt now knows about the most common printer fonts used for Asian languages. \section2 TQHttp This class provides a simple interface for HTTP downloads and uploads. \section2 Compatibility with the Standard Template Library (STL) Support for the C++ Standard Template Library has been added to the \link qt-template-lib.html TQt Template Library (TQTL)\endlink. The TQTL classes now contain appropriate copy constructors and typedefs so that they can be freely mixed with other STL containers and algorithms. In addition, new member functions have been added to TQTL template classes which correspond to STL-style naming conventions (e.g., push_back()). \section1 TQt Designer \link designer-manual.book TQt Designer\endlink was a pure dialog editor in TQt 2.2 but has now been extended to provide the full functionality of a GUI design tool. This includes the ability to lay out main windows with menus and toolbars. Actions can be edited within TQt Designer and then plugged into toolbars and menu bars via drag and drop. Splitters can now be used in a way similar to layouts to group widgets horizontally or vertically. In TQt 2.2, many of the dialogs created by TQt Designer had to be subclassed to implement functionality beyond the predefined signal and slot connections. Whilst the subclassing approach is still fully supported, Qt Designer now offers an alternative: a plugin for editing slots. The editor offers features such as syntax highlighting, completion, parentheses matching and incremental search. The functionality of TQt Designer can now be extended via plugins. Using TQt Designer's interface or by implementing one of the provided interfaces in a plugin, a two way communication between plugin and Qt Designer can be established. This functionality is used to implement plugins for custom widgets, so that they can be used as real widgets inside the designer. Basic support for project management has been added. This allows you to read and edit *.pro files, add and remove files to/from the project and do some global operations on the project. You can now open the project file and have one-click access to all the *.ui forms in the project. In addition to generating code via uic, TQt Designer now supports the dynamic creation of widgets directly from XML user interface description files (*.ui files) at runtime. This eliminates the need of recompiling your application when the GUI changes, and could be used to enable your customers to do their own customizations. Technically, the feature is provided by a new class, TQWidgetFactory in the QResource library. \section1 TQt Linguist \link linguist-manual.book TQt Linguist\endlink is a GUI utility to support translating the user-visible text in applications written with Qt. It comes with two command-line tools: lupdate and lrelease. Translation of a TQt application is a three-step process: \list \i Run lupdate to extract user-visible text from the C++ source code of the TQt application, resulting in a translation source file (a *.ts file). \i Provide translations for the source texts in the *.ts file using TQt Linguist. \i Run lrelease to obtain a light-weight message file (a *.qm file) from the *.ts file, which provides very fast lookup for released applications. \endlist Qt Linguist is a tool suitable for use by translators. Each user-visible (source) text is characterized by the text itself, a context (usually the name of the C++ class containing the text), and an optional comment to help the translator. The C++ class name will usually be the name of the relevant dialog, and the comment will often contain instructions that describe how to navigate to the relevant dialog. You can create phrase books for TQt Linguist to provide common translations to help ensure consistency and to speed up the translation process. Whenever a translator navigates to a new text to translate, TQt Linguist uses an intelligent algorithm to provide a list of possible translations: the list is composed of relevant text from any open phrase books and also from identical or similar text that has already been translated. Once a translation is complete it can be marked as "done"; such translations are included in the *.qm file. Text that has not been "done" is included in the *.qm file in its original form. Although Qt Linguist is a GUI application with dock windows and mouse control, toolbars, etc., it has a full set of keyboard shortcuts to make translation as fast and efficient as possible. When the TQt application that you're developing evolves (e.g. from version 1.0 to version 1.1), the utility lupdate merges the source texts from the new version with the previous translation source file, reusing existing translations. In some typical cases, lupdate may suggest translations. These translations are marked as unfinished, so you can easily find and check them. \section1 TQt Assistant Thanks to the positive feedback we received about the help system built into \link designer-manual.book TQt Designer\endlink, we decided to offer this part as a separate application called \link assistant.book TQt Assistant\endlink. TQt Assistant can be used to browse the TQt class documentation as well as the manuals for Qt Designer and TQt Linguist. It offers index searching, a contents overview, bookmarks history and incremental search. TQt Assistant is used by both TQt Designer and TQt Linguist for browsing their help documentation. \section1 qmake To ease portability we now provide the \link qmake-manual.book qmake\endlink utility to replace tmake. QMake is a C++ version of tmake which offers additional functionallity that is difficult to reproduce in tmake. Trolltech uses qmake in its build system for Qt and related products and we have released it as free software. */