aboutsummaryrefslogtreecommitdiffstats
path: root/src/quickcontrols/doc/src/qtquickcontrols-fusion.qdoc
blob: 05792fb7dab5d3761648245f8df9f1ec4dd990b0 (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
// Copyright (C) 2017 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \page qtquickcontrols-fusion.html
    \title Fusion Style

    The Fusion style is a desktop-oriented style.

    The Fusion style is a platform-agnostic style that offers a desktop-oriented
    look and feel. It implements the same design language as the
    \l {Qt Widget Gallery}{Fusion style for Qt Widgets}.

    \include style-screenshots.qdocinc {file} {Fusion} {fusion}

    To run an application with the Fusion style, see
    \l {Using Styles in Qt Quick Controls}.

    \note The Fusion style is not a native desktop style. The style runs on any
    platform, and looks similar everywhere. Minor differences may occur due to
    differences in the standard system palettes, available fonts, and font
    rendering engines.

    \section2 Customization

    The Fusion style uses the standard system \l[QtQuick]{Palette}
    to provide colors that match the desktop environment.

    \image qtquickcontrols-fusion-palettes.png

    Custom palettes can be specified for any control,
    \l{Popup::palette}{popup}, or \l{Window::palette}{application window}.
    Explicit palette attributes are automatically propagated from parent to children,
    overriding any system defaults for that attribute. In the following example,
    the window and all three switches appear with a violet highlight color:

    \table
        \row
            \li
                \qml
                import QtQuick 2.12
                import QtQuick.Controls 2.12

                ApplicationWindow {
                    visible: true

                    palette.highlight: "violet"

                    Column {
                        anchors.centerIn: parent

                        Switch { text: qsTr("First"); checked: true }
                        Switch { text: qsTr("Second"); checked: true }
                        Switch { text: qsTr("Third") }
                    }
                }
                \endqml
            \li
                \image qtquickcontrols-fusion-violet.png
    \endtable

    \b {See also} \l {Basic Style}, \l {Material Style}, \l {Universal Style}

    \section1 Related Information

    \list
      \li \l{Styling Qt Quick Controls}
    \endlist
*/