path: root/doc/src/examples-overview.qdoc

/****************************************************************************
**
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the either Technology Preview License Agreement or the
** Beta Release License Agreement.
**
** 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.0, 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 are unsure which license is appropriate for your use, please
** contact the sales department at http://www.qtsoftware.com/contact.
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
  \page examples-overview.html
  \title An Overview of Qt's Examples
  \brief A short guide to the different categories of examples included with Qt.
  \ingroup howto

  Qt is supplied with a variety of examples that cover almost every aspect
  of development. These examples are ordered by functional area, but many
  examples often use features from many parts of Qt to highlight one area
  in particular.

  This document provides a brief overview of each example category and
  provides links to the more formal \l{Qt Examples}{list of examples}.

  \section1 \l{Qt Examples#Widgets}{Widgets}

  \l{Qt Examples#Widgets}{\inlineimage widget-examples.png
  }

  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.

  \section1 \l{Qt Examples#Dialogs}{Dialogs}

  \l{Qt Examples#Dialogs}{\inlineimage dialog-examples.png
  }

  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.

  \section1 \l{Qt Examples#Main Windows}{Main Windows}

  \l{Qt Examples#Main Windows}{\inlineimage mainwindow-examples.png
  }

  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.

  \section1 \l{Qt Examples#Layouts}{Layouts}

  \l{Qt Examples#Layouts}{\inlineimage layout-examples.png
  }

  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.

  \section1 \l{Qt Examples#Painting}{Painting}

  \l{Qt Examples#Painting}{\inlineimage painting-examples.png
  }

  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.

  These examples show the most common techniques that are used when painting
  with Qt, from basic concepts such as drawing simple primitives to the use of
  transformations.

  \section1 \l{Qt Examples#Item Views}{Item Views}

  \l{Qt Examples#Item Views}{\inlineimage itemview-examples.png
  }

  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.

  \section1 \l{Qt Examples#Graphics View}{Graphics View}

  \l{Qt Examples#Graphics View}{\inlineimage graphicsview-examples.png
  }

  Qt is provided with a comprehensive canvas through the GraphicsView
  classes.

  These examples demonstrate the fundamental aspects of canvas programming
  with Qt.

  \section1 \l{Qt Examples#Rich Text}{Rich Text}

  \l{Qt Examples#Rich Text}{\inlineimage richtext-examples.png
  }

  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.

  \section1 \l{Qt Examples#Tools}{Tools}

  \l{Qt Examples#Tools}{\inlineimage tool-examples.png
  }

  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.

  \section1 \l{Qt Examples#Desktop}{Desktop}

  \l{Qt Examples#Desktop}{\inlineimage desktop-examples.png
  }

  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.

  \section1 \l{Qt Examples#Drag and Drop}{Drag and Drop}

  \l{Qt Examples#Drag and Drop}{\inlineimage draganddrop-examples.png
  }

  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.

  \section1 \l{Qt Examples#Threads}{Threads}

  \l{Qt Examples#Threads}{\inlineimage thread-examples.png
  }

  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.

  Additionally, it is now possible to move objects between threads.

  \section1 \l{Qt Examples#Concurrent Programming}{Concurrent Programming}

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

  These examples show how to apply the basic techniques of concurrent
  programming to simple problems.

  \section1 \l{Qt Examples#Network}{Network}

  \l{Qt Examples#Network}{\inlineimage network-examples.png
  }

  Qt is provided with an extensive set of network classes to support both
  client-based and server side network programming.

  These examples demonstrate the fundamental aspects of network programming
  with Qt.

  \section1 \l{Qt Examples#XML}{XML}

  \l{Qt Examples#XML}{\inlineimage xml-examples.png
  }

  XML parsing and handling is supported through SAX and DOM compliant APIs.

  Qt's SAX compliant classes allow you to parse XML incrementally; the DOM
  classes enable more complex document-level operations to be performed on
  XML files.

  \section1 \l{Qt Examples#XQuery, XPath}{XQuery, XPath}

  Qt provides an XQuery/XPath engine, QtXmlPatterns, for querying XML
  files and custom data models, similar to the model/view framework.

  \section1 \l{Qt Examples#OpenGL}{OpenGL}

  \l{Qt Examples#OpenGL}{\inlineimage opengl-examples.png
  }

  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.

  These examples demonstrate the basic techniques used to take advantage of
  OpenGL in Qt applications.

  \section1 \l{Qt Examples#SQL}{SQL}

  \l{Qt Examples#SQL}{\inlineimage sql-examples.png
  }

  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.

  \section1 \l{Qt Examples#Help System}{Help System}

  \l{Qt Examples#Help System}{\inlineimage assistant-examples.png
  }

  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.

  \section1 \l{Qt Examples#Qt Designer}{Qt Designer}

  \l{Qt Examples#Qt Designer}{\inlineimage designer-examples.png
  }

  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.

  \section1 \l{Qt Examples#UiTools}{UiTools}

  \l{Qt Examples#UiTools}{\inlineimage uitools-examples.png
  }

  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.

  \section1 \l{Qt Examples#Qt Linguist}{Qt Linguist}

  \l{Qt Examples#Qt Linguist}{\inlineimage linguist-examples.png
  }

  Internationalization is a core feature of Qt. These examples show how to
  access translation and localization facilities at run-time.

  \section1 \l{Qt Examples#Qt Script}{Qt Script}

  \l{Qt Examples#Qt Script}{\inlineimage qtscript-examples.png
  }

  Qt is provided with a powerful embedded scripting environment through the QtScript
  classes.

  These examples demonstrate the fundamental aspects of scripting applications
  with Qt.

  \section1 \l{Qt Examples#Phonon Multimedia Framework}{Phonon Multimedia Framework}

  \l{Qt Examples#Phonon Multimedia Framework}{\inlineimage phonon-examples.png
  }

  The Phonon Multimedia Framework brings multimedia support to Qt applications.

  The examples and demonstrations provided show how to play music and movies
  using the Phonon API.

  \section1 \l{Qt Examples#WebKit}{WebKit}

  \l{Qt Examples#WebKit}{\inlineimage webkit-examples.png
  }

  Qt provides an integrated Web browser component based on WebKit, the popular
  open source browser engine.

  These examples and demonstrations show a range of different uses for WebKit,
  from displaying Web pages within a Qt user interface to an implementation of
  a basic function Web browser.

  \section1 \l{Qt Examples#State Machine}{State Machine}

  Qt provides a powerful hierchical finite state machine through the Qt State
  Machine classes.

  These examples demonstrate the fundamental aspects of implementing
  Statecharts with Qt.

  \section1 \l{Qt Examples#Qt for Embedded Linux}{Qt for Embedded Linux}

  \l{Qt Examples#Qt for Embedded Linux}{\inlineimage qt-embedded-examples.png
  }

  These examples show how to take advantage of features specifically designed
  for use on systems with limited resources, specialized hardware, and small
  screens.

  \section1 \l{Qt Examples#ActiveQt}{ActiveQt}

  Qt is supplied with a number of example applications and demonstrations that
  have been written to provide developers with examples of the Qt API in use,
  highlight good programming practice, and showcase features found in each of
  Qt's core technologies.

  The example and demo launcher can be used to explore the different categories
  available. It provides an overview of each example, lets you view the
  documentation in Qt Assistant, and is able to launch examples and demos.

  \section1 \l{http://doc.trolltech.com/qq}{Another Source of Examples}

  One more valuable source for examples and explanations of Qt
  features is the archive of the \l {http://doc.trolltech.com/qq} 
  {Qt Quarterly}.

*/