qtquickcontrols-fusion.qdoc

Go to the documentation of this file.

// 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}.
 
    The Fusion style automatically switches dark and light themes according to
    the system settings. For information on how to set custom theme colors,
    refer to the \l {customize-fusion-style}{Customization} section.
 
    \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
    \target customize-fusion-style
 
    The Fusion style uses the standard system \l[QtQuick]{Palette}
    to provide colors that match the desktop environment.
 
    \image qtquickcontrols-fusion-palettes.png
           {Fusion style controls in three color palettes}
 
    You can specify custom palettes 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
                import QtQuick.Controls
 
                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
                       {Fusion style controls with custom violet palette}
    \endtable
 
    \b {See also} \l {Basic Style}, \l {Material Style}, \l {Universal Style}
 
    \section1 Related Information
 
    \list
      \li \l{Styling Qt Quick Controls}
    \endlist
*/