Qt Quick Controls Configuration File

Qt Quick Controls Reference Documentation.

Article lu fois.

L'auteur

The Qt Company Ltd.

L'article

Publié le 27 décembre 2024 - Mis à jour le 27 décembre 2024

Liens sociaux

Qt Quick Controls Configuration File▲

Qt Quick Controls support a special configuration file, qtquickcontrols2.conf, which is built into an application's resources.

The configuration file can specify the preferred style and certain style-specific attributes. The following example specifies that the preferred style is the https://. Furthermore, when the application is run with the Material style, its theme is light and the accent and primary colors are teal and blue grey, respectively. However, if the application is run with the https:// instead, the accent color is red and the appropriate theme is chosen based on the system theme colors.

Sélectionnez

[Controls]
Style=Material

[Universal]
Theme=System
Accent=Red

[Material]
Theme=Light
Accent=Teal
Primary=BlueGrey

It is possible to specify a custom location for the configuration file with the https:// environment variable.

Controls Section▲

The following values can be specified in a Controls section of the configuration file:

Variable	Description
Style	Specifies the style to run the application with. The value can be the name of one of the https:// or a https://.
FallbackStyle	Specifies the style to use for controls that are not implemented. The style must be one of the https://. By default, the https:// style is used.

Imagine Section▲

The following table lists values that can be used to configure the https:// in an Imagine section of the configuration file:

Variable	Description
Path	Specifies the https:// to the directory that contains the Imagine style assets. If not specified, the built-in assets are used. For example, to specify a path to a directory stored in the https://: Sélectionnez `[Imagine] Path=:/imagine-assets` To specify a relative path to a local directory: Sélectionnez `[Imagine] Path=imagine-assets` Due to a technical limitation, the path should not be named "imagine" if it is relative to the qtquickcontrols2.conf file.

Variable

Description

Path

Specifies the https:// to the directory that contains the Imagine style assets. If not specified, the built-in assets are used.

For example, to specify a path to a directory stored in the https://:

Sélectionnez

[Imagine]
Path=:/imagine-assets

To specify a relative path to a local directory:

Sélectionnez

[Imagine]
Path=imagine-assets

Due to a technical limitation, the path should not be named "imagine" if it is relative to the qtquickcontrols2.conf file.

Material Section▲

The following table lists values that can be used to configure the https:// in a Material section of the configuration file:

Variable	Description
Theme	Specifies the default https://. The value can be one of the available themes, for example "Dark".
Variant	Specifies the Material variant. The Material Design has two variants: a normal variant designed for touch devices, and a dense variant for desktop. The dense variant uses smaller sizes for controls and their fonts. The value can be "Normal" or "Dense".
Accent	Specifies the default https://. The value can be any https://, but it is recommended to use one of the https://, for example "Teal".
Primary	Specifies the default https://. The value can be any https://, but it is recommended to use one of the https://, for example "BlueGrey".
Foreground	Specifies the default https://. The value can be any https://, or one of the https://, for example "Brown".
Background	Specifies the default https://. The value can be any https://, or one of the https://, for example "Grey".

Universal Section▲

The following table lists values that can be used to configure the https:// in a Universal section of the configuration file:

Variable	Description
Theme	Specifies the default https://. The value can be one of the available themes, for example "Dark".
Accent	Specifies the default https://. The value can be any https://, but it is recommended to use one of the https://, for example "Violet".
Foreground	Specifies the default https://. The value can be any https://, or one of the https://, for example "Brown".
Background	Specifies the default https://. The value can be any https://, or one of the https://, for example "Steel".

Font Configuration▲

The default https:// can be specified in a Font sub-group in each style's section in the configuration file. The Font sub-group can be defined in two alternative ways:

Sélectionnez

[Default]
Font\Family=Open Sans
Font\PixelSize=20

[Material\Font]
Family=Open Sans
PixelSize=20

Supported font attributes:

Variable	Description
Family	The font family.
PointSize	The point size.
PixelSize	The pixel size.
StyleHint	The style hint. Available values: SansSerif, Helvetica, Serif, Times, TypeWriter, Courier, OldEnglish, Decorative, Monospace, Fantasy, Cursive.
Weight	The weight. Qt uses a weighting scale from 0 to 99 similar to, but not the same as, the scales used in Windows or CSS. A weight of 0 will be thin, whilst 99 will be extremely black. Available pre-defined weights: Thin (0), ExtraLight (12), Light (25), Normal (50), Medium (57), DemiBold (63), Bold (75), ExtraBold (81), Black (87).
Style	The style. Available values: StyleNormal, StyleItalic, StyleOblique.

Palette Configuration▲

The default https:// can be specified in a Palette sub-group in each style's section in the configuration file. The Palette sub-group can be defined in two alternative ways:

Sélectionnez

[Fusion]
Palette\Window=#dedede
Palette\WindowText=#212121

or:

Sélectionnez

[Fusion\Palette]
Window=#dedede
WindowText=#212121

See https:// for a full list of supported attributes.

Using the Configuration File in a Project▲

In order to make it possible for Qt Quick Controls to find the configuration file, it must be built into application's resources using the https://. Here's an example .qrc file:

Sélectionnez

&lt;!DOCTYPE RCC&gt;&lt;RCC version="1.0"&gt;
&lt;qresource prefix="/"&gt;
    &lt;file&gt;qtquickcontrols2.conf&lt;/file&gt;
&lt;/qresource&gt;
&lt;/RCC&gt;

Qt Quick Controls uses a file selector to load the configuration file. It is possible to provide a different configuration file for different platforms and locales. See QFileSelector documentation for more details.

Finally, the .qrc file must be listed in the application's .pro file so that the build system knows about it. For example:

Sélectionnez

RESOURCES = application.qrc

Related Information▲

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants :