Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qtquickcontrols-windows.qdoc
Go to the documentation of this file.
1// Copyright (C) 2021 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
3
4/*!
5 \page qtquickcontrols-windows.html
6 \title Windows Style
7
8 The Windows style is a style that looks native on Windows.
9 \l {detailed-desc-Windows}{More...}
10
11 \styleimport {QtQuick.Controls.Windows} {Qt 6.0}
12
13 \target detailed-desc-Windows
14
15 The Windows style is a style that looks native on Windows. The controls are drawn run-time using
16 native libraries, and is therefore only available for applications running on Windows.
17
18 \note Be aware that the apperance of this style can change from one minor Qt version to the
19 next, to better blend in with native applications on the platform.
20
21 \table
22 \row
23 \li \image qtquickcontrols-windows.png
24 \caption The Windows style
25 \endtable
26
27 To run an application with the Windows style, see
28 \l {Using Styles in Qt Quick Controls}.
29
30 \section2 Current state
31
32 The Windows style is under development, and some controls are not yet supported. Those controls
33 are: \l BusyIndicator, \l PageIndicator, \l TabBar and \l Tumbler.
34 Those will fall back to use the \l {Fusion Style}.
35
36 \section2 Customization
37
38 The goal of the Windows style is to for the controls look and feel as similar as possible to the
39 native controls on Windows. The style will follow the theme and colors configured globally from
40 Windows Settings, and does not come with a separate customization API on top of that.
41
42 \note The Windows style is not suitable for \l {Customizing Qt Quick Controls}{customizing}.
43 The main reason is that it sometimes draw both the contents and the background
44 onto a single background item, which will not look good together with a custom contentItem.
45 It also tends to use padding and inset values that are different from the other styles.
46 \include customizing-native-styles.qdocinc
47*/