// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \title Qt Widgets Examples
    \brief Lots of examples of how to use different kinds of widgets.
    \group examples-widgets

    \image widget-examples.png {Gallery of various widgets}

    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.

*/

/*!
    \title Painting Examples
    \brief How to use the Qt painting system.
    \group examples-painting

    \image painting-examples.png
           {Application showing different geometric shapes and styles}

    Qt's painting system is able to render vector graphics, images,
    and outline font-based text with sub-pixel 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.

*/

/*!
    \title Rich Text Examples
    \brief Using the document-oriented rich text engine.
    \group examples-richtext

    \image richtext-examples.png
           {Application showing various rich text widgets}

    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.

 */

/*!
    \title Desktop Examples
    \brief Integrating your Qt application with your favorite desktop.
    \group examples-desktop

    \image desktop-examples.png
           {Application showing widgets for desktop environments}


    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.

*/

/*!
    \group examples-dialogs
    \title Dialog Examples
    \brief Using Qt's standard dialogs and building and using custom dialogs.

    \image dialog-examples.png
           {Application showing a dialog}

    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.
*/

/*!
    \title Item Views Examples
    \brief Using the model/view framework.
    \group examples-itemviews

    \image itemviews-examples.png
           {Application showing a tree model editor}

    Qt provides a lot of capabalities to display pre- and user-defined item models
    in different ways.
    The separation of functionality introduced by the model/view architecture gives
    developers greater flexibility to customize the presentation of items.

*/

/*!
    \keyword Graphicsview Examples
    \title Graphics View Examples
    \brief Using the Graphics View framework.
    \page examples-graphicsview.html

    \image graphicsview-examples.png
    {Application showing various graphics options and views}

    Qt provides powerful graphics engine that supports easy visualization of items, with
    support for rotation and zooming.
    Additionally it provides an event propagation architecture for interaction.

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

    \annotatedlist{examples-graphicsview}

    These examples show the use of graphics widgets and layouts.

    \annotatedlist{examples-graphicsview-layout}

    Some examples demonstrate the use of graphics effects with canvas items.

    \annotatedlist{examples-graphicsview-graphicseffects}
*/

/*!
    \group examples-mainwindow
    \title Main Window Examples
    \brief Building applications around a main window.

    \image mainwindow-examples.png
           {Application showing various widgets in a main window}

    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.

*/

/*!
    \group examples-widgets-tools
    \ingroup all-examples
    \title Widget Tools Examples
    \brief Using autocomplete features, regular expressions, and undo framework.

    \image completer-example.png
           {Application showing different completer options and tools}

    Qt provides the functionality for autocomplete, Undo/Redo actions, and
    regular expressions for the Widget-based applications.

*/
/*!
    \group examples-user-input
    \ingroup all-examples
    \title User Input Examples
    \brief Using user input in Qt Widgets applications.

    \image imagegestures-example.png {Application handling touch gestures}

    Qt provides the functionality for handling user input and drag-and-drop in
    widget-based applications.

*/
