You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tqt3/doc/indices.doc

808 lines
20 KiB

/****************************************************************************
**
** Miscellaneous index pages
**
** 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 index.html
\if defined(commercial)
\title TQt Reference Documentation (Commercial Edition)
\endif
\if defined(noncommercial)
\title TQt Reference Documentation (Non-Commercial Edition)
\endif
\if !defined(commercial) && !defined(noncommercial)
\title TQt Reference Documentation (Open Source Edition)
\endif
<table cellpadding=2 cellspacing=1 border=0 width="100%" bgcolor="#e5e5e5">
\if !defined(commercial) && !defined(noncommercial)
<tr bgcolor="white"><td colspan=3 align="center"><b>Notice</b>: This edition is
for the development of \link opensourceedition.html Free and Open
Source\endlink software only; see \link commercialeditions.html
Commercial Editions\endlink.</td></tr>
\endif
\if defined(noncommercial)
<tr bgcolor="white"><td colspan=3 align="center"><b>Notice</b>: This
edition is for the development of non-commercial software in
accordance with the license you agreed to when you installed the
software from the CD; see also \link
commercialeditions.html Commercial Editions\endlink.</td></tr>
\endif
<tr>
<th bgcolor="#a2c511" width="33%">
Qt Community
</th>
<th bgcolor="#a2c511" width="33%">
Getting Started
</th>
<th bgcolor="#a2c511" width="33%">
General
</th>
</tr>
<tr>
<td valign="top">
\list
\i \link http://lists.trolltech.com Mailing lists\endlink
\i \link http://doc.trolltech.com/qq/index.html <i>TQt Quarterly</i> newsletter\endlink
\i \link http://www.trolltech.com/products/solutions/index.html Qt
Solutions\endlink
\i \link http://www.trolltech.com/freesoftware/index.html User contributed TQt additions\endlink
\i \link bughowto.html How to report a bug\endlink
\endlist
</td>
<td valign="top">
\list
\i \link how-to-learn-ntqt.html How to Learn Qt\endlink
\i \link http://www.trolltech.com/products/qt/readyforqt4.html Getting Ready for TQt 4\endlink
\i \link tutorial.html Tutorial #1\endlink,
\link tutorial2.html Tutorial #2\endlink
\i \link examples.html Examples\endlink
\i \link http://www.trolltech.com/products/qt/whitepaper.html Whitepaper\endlink
\endlist
</td>
<td valign="top">
\list
\i \link aboutntqt.html About Qt\endlink
\i \link commercialeditions.html Commercial Editions\endlink
\i \link opensourceedition.html Open Source Edition\endlink
\i \link troll.html About Trolltech\endlink
\endlist
</td>
</tr>
<tr>
<th bgcolor="#a2c511">
API Reference
</th>
<th bgcolor="#a2c511">
Modules
<th bgcolor="#a2c511">
Overviews
</tr>
<tr>
<td valign="top">
\list
\i \link classes.html All Classes\endlink
\i \link mainclasses.html Main Classes\endlink
\i \link groups.html Grouped Classes\endlink
\i \link annotated.html Annotated Classes\endlink
\i \link hierarchy.html Inheritance Hierarchy\endlink
\i \link classchart.html Class Chart (clickable image)\endlink
\i \link functions.html All Functions (long)\endlink
\i \link headers.html Header File Index\endlink
\i \link faq.html FAQs\endlink
\i \link http://www.trolltech.com/developer/changes/ Change History\endlink
\endlist
</td>
<td valign="top">
\list
\i \link modules.html All Modules\endlink
\i \link canvas.html Canvas\endlink
\i \link iconview.html Iconview\endlink
\i \link network.html Network\endlink
\i \link opengl.html OpenGL\endlink
\i \link sql.html SQL\endlink
\i \link table.html Table\endlink
\i \link workspace.html Workspace\endlink
\i \link xml.html XML\endlink
\endlist
</td>
<td valign="top">
\list
\i \link overviews-list.html All Overviews and HOWTOs\endlink
\i \link object.html TQt Object Model\endlink
\i \link signalsandslots.html Signals and Slots\endlink
\i \link geometry.html Window Geometry\endlink
\i \link eventsandfilters.html Events and Event Filters\endlink
\i \link i18n.html Internationalization (i18n)\endlink
\i \link debug.html Debugging Techniques\endlink
\i \link threads.html Thread Support in Qt\endlink
\i \link plugins-howto.html TQt Plugins\endlink
\i \link accelerators.html Standard Accelerators\endlink
\endlist
</tr>
<tr>
<th bgcolor="#a2c511">
Porting &amp; Platforms
</th>
<th bgcolor="#a2c511">
Tools
</th>
<th bgcolor="#a2c511">
Licenses &amp; Credits
</th>
</tr>
<tr>
<td valign="top">
\list
\i \link winsystem.html Window system specific notes\endlink
\i \link activentqt.html ActiveQt Framework\endlink
\i \link motif-extension.html Motif Extension\endlink
\i \link mac-differences.html Mac OS X development\endlink
\i \link porting.html Porting from TQt 2.x to TQt 3.x\endlink
\endlist
</td>
<td valign="top">
\list
\i \link tools-list.html All Tools\endlink
\i \link designer-manual.book TQt Designer\endlink
\i \link linguist-manual.book TQt Linguist\endlink
\i \link assistant.book TQt Assistant\endlink
\i \link qmake-manual.book qmake\endlink
\endlist
</td>
<td valign="top">
\list
\i \link license.html Q Public License\endlink
\i \link gpl.html GNU General Public License\endlink
\i \link 3rdparty.html Third Party Licenses used in Qt\endlink
\i \link licenses.html Other Licenses used in Qt\endlink
\i \link credits.html Credits\endlink
\endlist
</td>
</tr>
</table>
*/
/*! \page groups.html
\title Grouped Classes
This page provides a way of navigating Qt's classes by grouping
related classes together. Some classes may appear in more than one group.
\table
\header
\i Group
\i Description
\row
\i \link abstractwidgets.html Abstract Widgets \endlink
\i Abstract widget classes usable through subclassing.
\row
\i \link advanced.html Advanced Widgets \endlink
\i Advanced GUI widgets such as listviews and progress bars.
\row
\i \link basic.html Basic Widgets \endlink
\i Basic GUI widgets such as buttons, comboboxes and scrollbars.
\omit
\row
\i \link componentmodel.html Component Model \endlink
\i Interfaces and helper classes for the TQt Component Model.
\endomit
\row
\i \link database.html Database\endlink
\i Database related classes, e.g. for SQL databases.
\row
\i \link time.html Date and Time \endlink
\i Classes for handling date and time.
\row
\i \link draganddrop.html Drag and Drop \endlink
\i Classes dealing with drag and drop and mime type
encoding and decoding.
\row
\i \link environment.html Environment \endlink
\i Classes providing various global services such as
event handling, access to system settings and internationalization.
\row
\i \link events.html Events\endlink
\i Classes used to create and handle events.
\row
\i \link tools.html Utility Classes \endlink
\i Collection classes such as list, queue, stack and string, along
with other classes that can be used without needing QApplication.
\row
\i \link graphics.html Graphics and Printing \endlink
\i Classes providing drawing (and printing) primitives, including
OpenGL. (See also \link images.html Image Processing\endlink and \link
multimedia.html Multimedia\endlink)
\row
\i \link helpsystem.html Help System \endlink
\i Classes used to provide online-help for applications.
\row
\i \link images.html Image Processing \endlink
\i Digital image encoding, decoding and manipulation.
(See also \link graphics.html Graphics and Printing\endlink and \link
multimedia.html Multimedia\endlink)
\row
\i \link geomanagement.html Layout Management \endlink
\i Classes handling automatic resizing and moving of widgets, for
composing complex dialogs.
\row
\i \link shared.html Implicitly and Explicitly Shared
Classes\endlink
\i Classes that use reference counting for fast copying.
\row
\i \link io.html Input/Output and Networking \endlink
\i Classes providing file input and output along with directory and
network handling.
\row
\i \link application.html MainWindow and Related Classes \endlink
\i Everything you need for a typical modern main application window,
including menus, toolbars, workspace, etc.
\row
\i \link misc.html Miscellaneous \endlink
\i Various other useful classes
\row
\i \link multimedia.html Multimedia\endlink
\i Classes that provide support for graphics, sound, animation, etc.
(See also \link graphics.html Graphics and Printing\endlink and \link
images.html Image Processing\endlink)
\row
\i \link objectmodel.html Object Model \endlink
\i The TQt GUI toolkit's underlying object model.
\row
\i \link organizers.html Organizers \endlink
\i User interface organizers such as splitters, tab bars, button groups, etc.
\row
\i \link plugins.html Plugin Classes\endlink
\i Plugin related classes.
\row
\i \link dialogs.html Standard Dialogs \endlink
\i Ready-made dialogs for file, font, color selection and more.
\row
\i \link ntqtl.html Template Library\endlink
\i Qt's template library container classes.
\row
\i \link text.html Text Related Classes\endlink
\i Classes for text
processing. (See also \link xml-tools.html XML Classes\endlink.)
\row
\i \link thread.html Threading Classes\endlink
\i Classes that provide threading support.
\row
\i \link appearance.html Widget Appearance \endlink
\i Appearance customization with styles, fonts, colors etc.
\row
\i \link xml-tools.html XML Classes\endlink
\i Classes that support XML, via, for example DOM and SAX.
\endtable
*/
/*! \defgroup examples
\title Examples
Qt ships with lots of small and some medium-sized example programs
that teach you how to implement various tasks with Qt. Most of them will show how to
use a certain class or module, others aim at programming techniques
and TQt basics, and some of them simply want to show you what's possible.
Note that most of the examples assume that you have some experience with C++
and TQt and therefore are not commented extensively. If you are interested
in a line-by-line coverage please refer to the tutorials
\link tutorial.html Tutorial #1\endlink, and
\link tutorial2.html Tutorial #2\endlink, and also the
\link step-by-step-examples.html step-by-step examples \endlink.
\section1 TQt Base Classes: Assorted Examples
\list
\i \link qaction-examples.html QAction and QActionGroup \endlink
\i \link qfont-examples.html QFont, QFontMetrics, QFontInfo and QFontDatabase \endlink
\i \link qprocess-examples.html QProcess \endlink
\endlist
\section1 TQt Modules: Assorted Examples
\list
\i \link xml-examples.html XML examples \endlink
\i \link network-examples.html Network examples \endlink
\i \link opengl-examples.html OpenGL examples \endlink
\i \link table-examples.html Table examples \endlink
\i \link sql-examples.html SQL examples \endlink
\endlist
\section1 TQt Extensions: Assorted Examples
\list
\i \link activeqt-examples.html ActiveX support extension \endlink
\i \link motif-examples.html QMotif support extension \endlink
\omit \i \link xt-motif-examples.html Xt/Motif support extension \endlink \endomit
\i \link nsplugin-examples.html Qt-based plugins for web browsers \endlink
\endlist
\section1 Miscellaneous Examples
*/
/*! \defgroup qaction-examples
\title QAction Examples
The following example programs show how to use the
QAction and QActionGroup classes.
*/
/*! \defgroup qfont-examples
\title QFont Examples
The following example programs show how to use the
classes QFont, QFontMetrics, QFontInfo, and QFontDatabase.
*/
/*! \defgroup qprocess-examples
\title QProcess Examples
The following example programs show how to use the
QProcess class.
*/
/*! \defgroup network-examples
\title Network Examples
The following example programs demonstrate the use
of the TQt network module.
*/
/*! \defgroup opengl-examples
\title OpenGL Examples
The following example programs demonstrate the use
of the TQt OpenGL module.
*/
/*! \defgroup table-examples
\title Table Examples
The following example programs demonstrate the use
of the TQt table module.
*/
/*! \defgroup sql-examples
\title TQt SQL Examples
The following example programs show how to use the
Qt SQL classes.
*/
/*! \defgroup xml-examples
\title TQt XML Examples
The following example programs show how to use the
Qt XML classes.
*/
/*! \defgroup nsplugin-examples
\title Netscape Plugin Examples
The following example programs show how to write plugins
that can be used with web browsers supporting the LiveConnect
protocol.
For more information see the \link netscape-plugin.html Plugin Howto \endlink.
*/
/*! \defgroup motif-examples
\title QMotif Support Extension
The following example programs illustrate the use of the QMotif Extension
assisting in the migration process of old Xt and Motif based code
to the more comfortable TQt toolkit.
For more information see the \link motif-extension.html QMotif
Support Extension documentation. \endlink
*/
/*
\defgroup xt-motif-examples
\title TQt Xt/Motif Support Extension
The following example programs illustrate the use of the TQt Xt/Motif Extension
assisting in the migration process of old Xt and Motif based code
to the more comfortable TQt toolkit.
For more information see the \link xt.html TQt Xt/Motif Support
Extension documentation. \endlink
*/
/*! \defgroup step-by-step-examples
\title Step-by-step Examples
Step-by-step examples provide a careful explanation of
example code.
The covered example programs usually show how to use certain classes
or deal with programming techniques and TQt basics.
These examples are especially aimed at TQt novices and less experienced
programmers and try to make learning TQt as painless as possible.
*/
/*! \defgroup tools
\title Non-GUI Classes
The non-GUI classes are general-purpose collection and string classes
that may be used independently of the GUI classes.
In particular, these classes do not depend on QApplication at all,
and so can be used in non-GUI programs.
See also the \link collection.html introduction to the TQt collection
classes. \endlink
*/
/*! \defgroup io
\title Input/Output and Networking
These classes are used to handle input and output to and from external
devices, processes, files etc. as well as manipulating files and directories.
*/
/*! \defgroup basic
\title Basic Widgets
These basic controls (widgets) are designed for direct use. There are
also some \link abstractwidgets.html abstract widget classes, \endlink
designed for subclassing, and some \link advanced.html more complex
widgets. \endlink
*/
/*! \defgroup advanced
\title Advanced Widgets
These classes provide more complex user interface controls (widgets).
*/
/*! \defgroup abstractwidgets
\title Abstract Widget Classes
These classes are abstract widgets; they are generally not usable in
themselves, but provide functionality that can be used by inheriting
these classes.
*/
/*! \defgroup objectmodel
\title Object Model
These classes form the basis of the \link object.html TQt Object Model \endlink.
*/
/* \defgroup componentmodel
\title Component Model
These classes and interfaces form the basis of the \link component.html TQt Component Model \endlink.
*/
/*! \defgroup plugins
\title Plugins
These classes deal with shared libraries, (e.g. .so and DLL files),
and with TQt plugins.
See the \link plugins-howto.html plugins documentation\endlink.
See also the \link activentqt.html ActiveQt framework\endlink for
Windows.
*/
/*! \defgroup organizers
\title Organizers
These classes are used to organize and group GUI primitives into more
complex applications or dialogs.
*/
/*! \defgroup dialogs
\title Dialog Classes
These classes are complex widgets, composed of simpler widgets; dialog
boxes, generally.
*/
/*! \defgroup images
\title Image Processing Classes
These classes are used for manipulating images.
*/
/*! \defgroup graphics
\title Graphics Classes
These classes provide powerful graphics drawing primitives for both 2D
and (with OpenGL) 3D.
<p>See also this introduction to the \link coordsys.html Qt
coordinate system. \endlink
*/
/*! \defgroup draganddrop
\title Drag And Drop Classes
These classes deal with drag and drop and the necessary mime type
encoding and decoding. See also \link dnd.html Drag and Drop with
Qt. \endlink
*/
/*! \defgroup appearance
\title Widget Appearance and Style
These classes are used to customize an application's appearance and
style.
*/
/*! \defgroup shared
\title Implicitly and Explicitly Shared Classes
These classes are normally-heavy classes which in TQt have been
optimized by the use of reference counter and common data so they can
be passed around.
The only important effect is that the classes listed here \e can
be passed around as arguments efficiently, even though they may
seem heavyweight.
*/
/*! \defgroup time
\title Time and Date
These classes provide system-independent date and time abstractions.
<p>Also available: \link y2k.html TQt Year 2000 Compliance Statement \endlink.
*/
/*! \defgroup application
\title Main Window and Related Classes
These classes provide everything you need for a typical modern main
application window, like the main window itself, menu and tool bars,
a statusbar, etc.
*/
/*! \defgroup geomanagement
\title Layout Management
These classes provide automatic geometry (layout) management of widgets.
*/
/*! \defgroup helpsystem
\title Help System
\keyword help system
These classes provide for all forms of online-help in your application,
with three levels of detail:
\list 1
\i Tool Tips and Status Bar message - flyweight help, extremely brief,
entirely integrated in the user interface, requiring little
or no user interaction to invoke.
\i What's This? - lightweight, but can be
a three-paragraph explanation.
\i Online Help - can encompass any amount of information,
but is typically slower to call up, somewhat separated
from the user's work, and often users feel that using online
help is a digression from their real task.
\endlist
*/
/*! \defgroup environment
\title Environment Classes
These classes providing various global services to your application such as
event handling, access to system settings, internationalization, etc.
*/
/*! \defgroup misc
\title Miscellaneous Classes
These classes are useful classes not fitting into any other category.
*/
/*! \defgroup events
\title Event Classes
These classes are used to create and handle events.
For more information see the \link object.html Object model\endlink
and \link signalsandslots.html Signals and Slots\endlink.
*/
/*! \defgroup multimedia
\title Multimedia Classes
These classes provide support for graphics, sound, animation etc.
*/
/*! \defgroup qtl
\title TQt Template Library Classes
The TQt Template Library (QTL) is a set of templates that provide
object containers. See the \link qt-template-lib.html TQt Template
Library\endlink.
*/
/*! \defgroup database
\title Database Classes
These classes provide access to SQL databases.
*/
/*! \defgroup thread
\title Threading
These classes are relevant to threaded applications.
*/
/*! \defgroup xml-tools
\title XML
These classes are relevant to XML users.
*/
/*! \defgroup qws
\title Qt/Embedded
These classes are relevant to Qt/Embedded users.
*/
/*! \defgroup text
\title Text Related Classes
These classes are relevant to text processing. See also the
\link xml.html XML classes \endlink.
*/