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: Sélectionnez To specify a relative path to a local directory: Sélectionnez 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". |