diff options
Diffstat (limited to 'src/quickcontrols2/doc/src/qtquickcontrols2-styles.qdoc')
-rw-r--r-- | src/quickcontrols2/doc/src/qtquickcontrols2-styles.qdoc | 209 |
1 files changed, 0 insertions, 209 deletions
diff --git a/src/quickcontrols2/doc/src/qtquickcontrols2-styles.qdoc b/src/quickcontrols2/doc/src/qtquickcontrols2-styles.qdoc deleted file mode 100644 index 12993fbf..00000000 --- a/src/quickcontrols2/doc/src/qtquickcontrols2-styles.qdoc +++ /dev/null @@ -1,209 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2017 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 qtquickcontrols2-styles.html - \title Styling Qt Quick Controls - - \section1 Available Styles - - Qt Quick Controls comes with a selection of styles. - - \section2 Basic Style - - \image qtquickcontrols2-basic-thumbnail.png - The \l {Basic Style} is a simple and light-weight all-round style that offers - the maximum performance for Qt Quick Controls. - - \section2 Fusion Style - - \image qtquickcontrols2-fusion-thumbnail.png - The \l {Fusion Style} is a platform-agnostic style that offers a desktop-oriented - look and feel for Qt Quick Controls. - - \section2 Imagine Style - - \image qtquickcontrols2-imagine-thumbnail.png - The \l {Imagine Style} is based on image assets. The style comes with a default - set of images which can easily be changed by providing a directory - with images using a predefined naming convention. - - \section2 macOS Style - - \image qtquickcontrols2-macos-thumbnail.png - The \l {macOS Style} is a native-looking style for macOS. - \note this style is only available for applications running on macOS. - - \section2 Material Style - - \image qtquickcontrols2-material-thumbnail.png - The \l {Material Style} offers an appealing design based on the - \l {https://www.google.com/design/spec/material-design/introduction.html} - {Google Material Design Guidelines}, but requires more system resources than - the Basic style. - - \section2 Universal Style - - \image qtquickcontrols2-universal-thumbnail.png - The \l {Universal Style} offers an appealing design based on the - \l {https://dev.windows.com/design}{Microsoft Universal Design Guidelines}, - but requires more system resources than the Basic style. - - \section2 Windows Style - - \image qtquickcontrols2-windows-thumbnail.png - The \l {Windows Style} is a native-looking style for Windows. - \note this style is only available for applications running on Windows. - - \section1 Using Styles in Qt Quick Controls - - There are two ways of using styles in Qt Quick Controls: - run-time style selection and compile-time style selection. - - \section2 Compile-Time Style Selection - - Compile-time style selection involves using QML imports to specify the - style. For example, to import the Material style: - - \qml - import QtQuick.Controls.Material - - ApplicationWindow { - // ... - } - \endqml - - Notice that QtQuick.Controls (which is responsible for run-time style - selection) is not imported. The fallback style is specified by the qmldir - of the style: - - \badcode - module QtQuick.Controls.Material - # ... - import QtQuick.Controls.Basic auto - \endcode - - The benefit of compile-time style selection is that the QtQuick.Controls plugin - is not used and therefore does not need to be deployed with the application. - - Explicit imports are also necessary if your application is built - \l {Static Builds}{statically}. - - \section2 Run-Time Style Selection - - Run-time style selection involves importing \c QtQuick.Controls: - - \qml - import QtQuick.Controls - \endqml - - The QtQuick.Controls plugin will import the style and fallback - style that were set at runtime via one of the following approaches: - - \list - \li \l[CPP]{QQuickStyle::setStyle()} - \li The \c -style command line argument - \li The \c QT_QUICK_CONTROLS_STYLE environment variable - \li The \c qtquickcontrols2.conf configuration file - \endlist - - The priority of these approaches follows the order they are listed, - from highest to lowest. That is, using \c QQuickStyle to set the style will - always take priority over using the command line argument, for example. - - The benefit of run-time style selection is that a single application binary - can support multiple styles, meaning that the end user can choose which - style to run the application with. - - \section3 Using QQuickStyle in C++ - - \l[CPP]{QQuickStyle} provides C++ API for configuring a specific - style. The following example runs a Qt Quick Controls application - with the Material style: - - \code - QQuickStyle::setStyle("Material"); - \endcode - - See the detailed description of \l[CPP]{QQuickStyle} for more - details. - - \section3 Command line argument - - Passing a \c -style command line argument is the convenient way to test different - styles. It takes precedence over the other methods listed below. The following - example runs a Qt Quick Controls application with the Material style: - - \code - ./app -style material - \endcode - - \section3 Environment variable - - Setting the \c QT_QUICK_CONTROLS_STYLE environment variable can be used to set - a system-wide style preference. It takes precedence over the configuration file - mentioned below. The following example runs a Qt Quick Controls application with - the Universal style: - - \code - QT_QUICK_CONTROLS_STYLE=universal ./app - \endcode - - See \l {Supported Environment Variables in Qt Quick Controls} for the full list - of supported environment variables. - - \section3 Configuration file - - Qt Quick Controls support a special configuration file, \c :/qtquickcontrols2.conf, - that is built into an application's resources. - - The configuration file can specify the preferred style (may be overridden by either - of the methods described earlier) and certain style-specific attributes. The following - example specifies that the preferred style is the Material style. - - \code - [Controls] - Style=Material - \endcode - - See \l {Qt Quick Controls Configuration File} for more details about the - configuration file. - - \section1 Related Information - \list - \li \l {Basic Style} - \li \l {Fusion Style} - \li \l {Imagine Style} - \li \l {Material Style} - \li \l {Universal Style} - \li \l {Customizing Qt Quick Controls} - \li \l {Using File Selectors with Qt Quick Controls} - \li \l {Deploying Qt Quick Controls Applications} - \li \l {Qt Quick Controls Configuration File} - \li \l {Supported Environment Variables in Qt Quick Controls} - \endlist -*/ |