/****************************************************************************
**
** 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 qtquick-usecase-styling.html
\title Use Case - Style And Theme Support
\brief Example of how to style user interface components in QML.

Styling with QML involves creating a visual type and binding that to a property
or by directly assigning a value to a property. For types that incorporate
Qt Quick's \l{Models and Views in Qt Quick}{delegates} the visual type attaches
to the \e delegate property.

\omit
When using Qt Quick Controls 1, the controls automatically set
the appropriate style from the respective \l{Supported Platforms}{platforms}.
\endomit

\omit
\section1 Using the Styling QML Types

The Qt Quick Controls 1 controls have a \c style property to which the
\e{styling types} bind. The controls have a corresponding styling type
from the Qt Quick Controls 1 Styles QML Types module.
For example,  QtQuickControls1 Button has a ButtonStyle type and Menu
has a MenuStyle type. The styling types provide properties
applicable to their respective controls such as the background, label,
or for some controls, the cursor appearance.

\snippet qmlapp/usecases/styling.qml 0

\note Qt Quick Controls 1 Styles was introduced in Qt 5.1 and requires
\l{Qt Quick} 2.1.
\endomit

\section1 Accessing the System Palette

The \l{SystemPalette} type provides information about the system's palette
information. QML applications can use this information to set the appearance
of visual types to match the native look and feel. In addition, on
\l{Desktop Platforms}{desktop} platforms, different color palettes are employed
when changing states, for example, when the application loses keyboard focus.

When using the controls, the system colors are already used.
*/
