summaryrefslogtreecommitdiffstats
path: root/src/widgets/doc/src/widgets-and-layouts/gallery.qdoc
blob: 8f57b9760a8c39a94ab2ec3b0b62f8d44f9ffb32 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
/****************************************************************************
**
** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
  \page gallery.html
  \title Qt Widget Gallery
  \brief Qt widgets shown in different styles on various platforms.

  Qt's support for widget styles and themes enables your application to fit in
  with the native desktop environment.

  The widgets examples show how some of the widgets available in Qt might
  appear when configured to use the a particular style. Each style is only
  available on the respective platfom, and provides native look and feel by
  integrating to the platform theme. Thus, the final appearance varies
  depending on the active theme.

    \table
        \row
            \li The Windows style ("windows") is provided by QWindowsStyle.
            \li \image windows-style.png Windows Style
        \row
            \li \image windows-vista-style.png Windows Vista Style
            \li The Windows Vista style ("windowsvista") is provided by
                QWindowsVistaStyle.
        \row
            \li The \macos style ("macos") is provided by QMacStyle.
            \li \image macos-style.png \macos Style
        \row
            \li \image fusion-style.png Fusion Style
            \li The Fusion style ("fusion") is provided by QFusionStyle.
    \endtable

    The Styles example displays the following widgets:

    \list
        \li QCheckBox (1) provides a checkbox with a text label.
        \li QRadioButton (2) provides a radio button with a text or pixmap
            label.
        \li QPushButton (3) provides a command button.
        \li QTabWidget (4) provides a stack of tabbed widgets.
        \li QTableWidget (5) provides a classic item-based table view.
        \li QScrollBar (6) provides a vertical or horizontal scroll bar.
        \li QProgressBar (7) provides a horizontal progress bar.
        \li QDateTimeEdit (8) provides a widget for editing dates and times.
        \li QSlider (9) provides a vertical or horizontal slider.
        \li QDial (10) provides a rounded range control (like a speedometer
            or potentiometer).
    \endlist

    The Calendar Widget example displays some additional widgets, here run on
    Windows 10 and \macos:

    \image windows-style2.png
    \caption Calendar Widget example on Windows 10

    \image macos-style2.png
    \caption Calendar Widget example on \macos

    \list
        \li QGroupBox (1) provides a group box frame with a title.
        \li QCalendarWidget (2) provides a monthly calendar widget
            that can be used to select dates.
        \li QLabel (3) provides a text or image display.
        \li QDateEdit (4) provides a widget for editing dates.
        \li QComboBox (5) provides a combined button and pop-up list.
    \endlist
*/