source: trunk/doc/src/getting-started/examples.qdoc@ 624

/****************************************************************************
**
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation ([email protected])
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** Commercial Usage
** Licensees holding valid Qt Commercial licenses may use this file in
** accordance with the Qt Commercial License Agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Nokia.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights.  These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met: http://www.gnu.org/copyleft/gpl.html.
**
** If you have questions regarding the use of this file, please contact
** Nokia at [email protected].
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
    \page examples-overview.html
    \raw HTML
    <script>
    document.location.href = "examples.html";
    </script>
    \endraw
    Click this \l{Qt Examples}{link} if you don't get redirected.
*/

/*!
    \page examples.html
    \title Qt Examples
    \brief The example programs provided with Qt.

    \previouspage Tutorials
    \contentspage How to Learn Qt
    \nextpage Qt Demonstrations

    Qt is supplied with a variety of examples that cover almost every aspect
    of development. They are not all designed to be impressive when you run
    them, but their source code is carefully written to show good Qt
    programming practices. You can launch any of these programs from the
    \l{Examples and Demos Launcher} application.

    These examples are ordered by functional area, but many examples often
    use features from many parts of Qt to highlight one area in particular.
    If you are new to Qt, you should probably start by going through the
    \l{Tutorials} before you have a look at the
    \l{mainwindows/application}{Application} example.

    In addition to the examples and the tutorial, Qt includes a
    \l{Qt Demonstrations}{selection of demos} that deliberately show off
    Qt's features. You might want to look at these as well.

    \table
    \row
    \o{2,1} \l{Widgets Examples}{\bold Widgets}
    \o{2,1} \l{Dialog Examples}{\bold Dialogs}
    \row
    \o \image widget-examples.png
    \o 
    Qt comes with a large range of standard widgets that users of modern
    applications have come to expect. You can also develop your own custom
    widgets and controls, and use them alongside standard widgets.

    It is even possible to provide custom styles and themes for widgets that can
    be used to change the appearance of standard widgets and appropriately
    written custom widgets.

    \o \image dialog-examples.png Dialogs
    \o 
    Qt includes standard dialogs for many common operations, such as file
    selection, printing, and color selection.

    Custom dialogs can also be created for specialized modal or modeless
    interactions with users.

    \row
    \o{2,1} \l{Main Window Examples}{\bold{Main Windows}}
    \o{2,1} \l{Layout Examples}{\bold Layouts}

    \row
    \o \image mainwindow-examples.png MainWindows
    \o All the standard features of application main windows are provided by Qt.

    Main windows can have pull down menus, tool bars, and dock windows. These
    separate forms of user input are unified in an integrated action system that
    also supports keyboard shortcuts and accelerator keys in menu items.

    \o \image layout-examples.png Layouts
    \o 
    Qt uses a layout-based approach to widget management. Widgets are arranged in
    the optimal positions in windows based on simple layout rules, leading to a
    consistent look and feel.

    Custom layouts can be used to provide more control over the positions and
    sizes of child widgets.

    \row
    \o{2,1} \l{Item Views Examples}{\bold{Item Views}}
    \o{2,1} \l{Graphics View Examples}{\bold{Graphics View}}
    \row
    \o \image itemview-examples.png ItemViews
    \o
    Item views are widgets that typically display data sets. Qt 4's model/view
    framework lets you handle large data sets by separating the underlying data
    from the way it is represented to the user, and provides support for
    customized rendering through the use of delegates.

    \o \image graphicsview-examples.png GraphicsView
    \o
    Qt is provided with a comprehensive canvas through the GraphicsView
    classes.

    \row
    \o{2,1} \l{Painting Examples}{\bold{Painting}}
    \o{2,1} \l{Rich Text Examples}{\bold{Rich Text}}
    \row
    \o \image painting-examples.png Painting
    \o
    Qt's painting system is able to render vector graphics, images, and outline
    font-based text with sub-pixel accuracy accuracy using anti-aliasing to
    improve rendering quality.

    \o \image richtext-examples.png RichText
    \o
    Qt provides powerful document-oriented rich text engine that supports Unicode
    and right-to-left scripts. Documents can be manipulated using a cursor-based
    API, and their contents can be imported and exported as both HTML and in a
    custom XML format.

    \row
    \o{2,1} \l{Desktop Examples}{\bold Desktop}
    \o{2,1} \l{Drag and Drop Examples}{\bold{Drag and Drop}}
    \row
    \o \image desktop-examples.png
    \o
    Qt provides features to enable applications to integrate with the user's
    preferred desktop environment.

    Features such as system tray icons, access to the desktop widget, and
    support for desktop services can be used to improve the appearance of
    applications and take advantage of underlying desktop facilities.

    \o \image draganddrop-examples.png DragAndDrop
    \o
    Qt supports native drag and drop on all platforms via an extensible
    MIME-based system that enables applications to send data to each other in the
    most appropriate formats.

    Drag and drop can also be implemented for internal use by applications.

    \row
    \o{2,1} \l{Threading and Concurrent Programming Examples}{\bold{Threading and Concurrent Programming}}
    \o{2,1} \l{Tools Examples}{\bold{Tools}}
    \row
    \o \image thread-examples.png
    \o
    Qt 4 makes it easier than ever to write multithreaded applications. More
    classes have been made usable from non-GUI threads, and the signals and slots
    mechanism can now be used to communicate between threads.

    The QtConcurrent namespace includes a collection of classes and functions
    for straightforward concurrent programming.

    \o \image tool-examples.png Tools
    \o
    Qt is equipped with a range of capable tool classes, from containers and
    iterators to classes for string handling and manipulation.

    Other classes provide application infrastructure support, handling plugin
    loading and managing configuration files.

    \row
    \o{2,1} \l{Network Examples}{\bold{Network}}
    \o{2,1} \l{Inter-Process Communication Examples}{\bold{Inter-Process Communication}}
    \row
    \o \image network-examples.png Network
    \o
    Qt is provided with an extensive set of network classes to support both
    client-based and server side network programming.

    \o \image ipc-examples.png IPC
    \o

    \row
    \o{2,1} \l{OpenGL Examples}{\bold{OpenGL}}\bold{ and }\l{OpenVG Examples}{\bold{OpenVG}}\bold{ Examples}
    \o{2,1} \l{Multimedia Examples}{\bold{Multimedia Framework}}
    \row
    \o \image opengl-examples.png OpenGL
    \o
    Qt provides support for integration with OpenGL implementations on all
    platforms, giving developers the opportunity to display hardware accelerated
    3D graphics alongside a more conventional user interface.

    Qt provides support for integration with OpenVG implementations on
    platforms with suitable drivers.

    \o \image phonon-examples.png
    \o
    Qt provides low-level audio support on linux,windows and mac platforms by default and
    an audio plugin API to allow developers to implement there own audio support for
    custom devices and platforms.

    The Phonon Multimedia Framework brings multimedia support to Qt applications.

    \row
    \o{2,1} \l{SQL Examples}{\bold{SQL}}
    \o{2,1} \l{XML Examples}{\bold{XML}}
    \row
    \o \image sql-examples.png SQL
    \o
    Qt provides extensive database interoperability, with support for products
    from both open source and proprietary vendors.

    SQL support is integrated with Qt's model/view architecture, making it easier
    to provide GUI integration for your database applications.

    \o \image xml-examples.png XML
    \o
    XML parsing and handling is supported through SAX and DOM compliant APIs
    as well as streaming classes.

    The XQuery/XPath and XML Schema engines in the QtXmlPatterns modules
    provide classes for querying XML files and custom data models.

    \row
    \o{2,1} \l{Qt Designer Examples}{\bold{Qt Designer}}
    \o{2,1} \l{UiTools Examples}{\bold UiTools}
    \row
    \o \image designer-examples.png Designer
    \o
    Qt Designer is a capable graphical user interface designer that lets you
    create and configure forms without writing code. GUIs created with
    Qt Designer can be compiled into an application or created at run-time.

    \o \image uitools-examples.png UiTools
    \o

    \row
    \o{2,1} \l{Qt Linguist Examples}{\bold{Qt Linguist}}
    \o{2,1} \l{Qt Script Examples}{\bold{Qt Script}}
    \row
    \o \image linguist-examples.png QtLinguist
    \o
    Internationalization is a core feature of Qt.

    \o \image qtscript-examples.png
    \o
    Qt is provided with a powerful embedded scripting environment through the QtScript
    classes.

    \row
    \o{2,1} \l{WebKit Examples}{\bold WebKit}
    \o{2,1} \l{Help System Examples}{\bold{Help System}}
    \row
    \o \image webkit-examples.png
    \o
    Qt provides an integrated Web browser component based on WebKit, the popular
    open source browser engine.

    \o \image assistant-examples.png HelpSystem
    \o
    Support for interactive help is provided by the Qt Assistant application.
    Developers can take advantages of the facilities it offers to display
    specially-prepared documentation to users of their applications.

    \row
    \o{2,1} \l{State Machine Examples}{\bold{State Machine}}
    \o{2,1} \l{Animation Framework Examples}{\bold{Animation Framework}}
    \row
    \o \image statemachine-examples.png
    \o
    Qt provides a powerful hierarchical finite state machine through the Qt State
    Machine classes.

    \o \image animation-examples.png
    \o
    These examples show to to use the \l{The Animation Framework}{animation framework}
    to build highly animated, high-performance GUIs.

    \row
    \o{2,1} \l{Multi-Touch Examples}{\bold{Multi-Touch Framework}}
    \o{2,1} \l{Gestures Examples}{\bold{Gestures}}

    \row
    \o \image multitouch-examples.png
    \o
    Support for multi-touch input makes it possible for developers to create
    extensible and intuitive user interfaces.

    \o \image gestures-examples.png
    \o
    Applications can be written to respond to gestures as a natural input method.
    These examples show how to enable support for standard and custom gestures in
    applications.

    \row
    \o{2,1} \l{D-Bus Examples}{\bold{D-Bus}}
    \o{2,1} \l{Qt for Embedded Linux Examples}{\bold{Qt for Embedded Linux}}

    \row
    \o \image qt-embedded-examples.png
    \o
    Systems with limited resources, specialized hardware, and small
    screens require special attention.