Supported Environment Variables in Qt Quick Controls#

This page contains a list of all environment variables that Qt Quick Controls supports. The environment variables are primarily meant for testing purposes, but they can also be used to set system-wide defaults.

Variable

Description

QT_QUICK_CONTROLS_STYLE

Specifies the default Qt Quick Controls style . The value can be either one of the built-in styles, for example "Material", or a custom style such as "MyStyle".

QT_QUICK_CONTROLS_FALLBACK_STYLE

Specifies a fallback style for custom styles . The value can be one of the built-in styles, for example "Material",

QT_QUICK_CONTROLS_CONF

Specifies the location of the Qt Quick Controls configuration file . By default, the configuration file is loaded from the application’s resources in ":/qtquickcontrols2.conf".

QT_QUICK_CONTROLS_HOVER_ENABLED

Specifies whether Qt Quick Controls use hover effects . The value can be set to 0 or 1 to disable or enable hover effects, respectively.

Imagine style specific environment variables:

Variable

Description

QT_QUICK_CONTROLS_IMAGINE_PATH

Specifies the path 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 resource system:

QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets

To specify a relative path to a local directory:

QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets

Note

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

QT_QUICK_CONTROLS_IMAGINE_SMOOTH

Set to 1 to enable smooth scaling for 9-patch images. This environment variable was added in Qt 6.5.

Material style specific environment variables:

Variable

Description

QT_QUICK_CONTROLS_MATERIAL_THEME

Specifies the default Material theme . The value can be one of the available themes, for example "Dark".

QT_QUICK_CONTROLS_MATERIAL_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".

QT_QUICK_CONTROLS_MATERIAL_ACCENT

Specifies the default Material accent color . The value can be any color, but it is recommended to use one of the pre-defined Material colors , for example "Teal".

QT_QUICK_CONTROLS_MATERIAL_PRIMARY

Specifies the default Material primary color . The value can be any color, but it is recommended to use one of the pre-defined Material colors , for example "BlueGrey".

QT_QUICK_CONTROLS_MATERIAL_FOREGROUND

Specifies the default Material foreground color . The value can be any color, or one of the pre-defined Material colors , for example "Brown".

QT_QUICK_CONTROLS_MATERIAL_BACKGROUND

Specifies the default Material background color . The value can be any color, or one of the pre-defined Material colors , for example "Grey".

Universal style specific environment variables:

Variable

Description

QT_QUICK_CONTROLS_UNIVERSAL_THEME

Specifies the default Universal theme . The value can be one of the available themes, for example "Dark".

QT_QUICK_CONTROLS_UNIVERSAL_ACCENT

Specifies the default Universal accent color . The value can be any color, but it is recommended to use one of the pre-defined Universal colors , for example "Violet".

QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND

Specifies the default Universal foreground color . The value can be any color, or one of the pre-defined Universal colors , for example "Brown".

QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND

Specifies the default Universal background color . The value can be any color, or one of the pre-defined Universal colors , for example "Steel".