Qt Quick Controls 中支持的环境变量

本页面包含Qt Quick Controls支持的所有环境变量的列表。这些环境变量主要用于测试目的,但也可以用于设置系统范围的默认值。

变量

描述

QT_QUICK_CONTROLS_STYLE

指定默认的Qt Quick Controls 样式。该值可以是内置样式之一,例如"Material",或自定义样式,如"MyStyle"

QT_QUICK_CONTROLS_FALLBACK_STYLE

指定自定义样式的回退样式。该值可以是内置样式之一,例如"Material"

QT_QUICK_CONTROLS_CONF

指定Qt Quick Controls 配置文件的位置。默认情况下,配置文件从应用程序的资源中加载,路径为":/qtquickcontrols2.conf"

QT_QUICK_CONTROLS_HOVER_ENABLED

指定Qt Quick Controls是否使用悬停效果。该值可以设置为01,分别禁用或启用悬停效果。

想象风格 特定的环境变量:

变量

描述

QT_QUICK_CONTROLS_IMAGINE_PATH

指定包含Imagine样式资源的目录路径。如果未指定,则使用内置资源。

例如,指定存储在资源系统中的目录路径:

QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets

指定本地目录的相对路径:

QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets

注意

由于技术限制,如果路径相对于qtquickcontrols2.conf文件,则不应命名为“imagine”

QT_QUICK_CONTROLS_IMAGINE_SMOOTH

设置为 1 以启用9-patch图像的平滑缩放。此环境变量在Qt 6.5中添加。

Material style 特定的环境变量:

变量

描述

QT_QUICK_CONTROLS_MATERIAL_THEME

指定默认的Material主题。该值可以是可用主题之一,例如"Dark"

QT_QUICK_CONTROLS_MATERIAL_VARIANT

指定Material变体。Material Design有两种变体:一种是为触摸设备设计的普通变体,另一种是为桌面设计的密集变体。密集变体使用较小的控件尺寸和字体。

值可以是"Normal""Dense"

QT_QUICK_CONTROLS_MATERIAL_ACCENT

指定默认的Material强调色。该值可以是任何颜色,但建议使用预定义的Material颜色之一,例如"Teal"

QT_QUICK_CONTROLS_MATERIAL_PRIMARY

指定默认的Material 主色。该值可以是任何颜色,但建议使用预定义的 Material 颜色之一,例如 "BlueGrey"

QT_QUICK_CONTROLS_MATERIAL_FOREGROUND

指定默认的Material前景色。该值可以是任何颜色,或者是预定义的Material颜色之一,例如"Brown"

QT_QUICK_CONTROLS_MATERIAL_BACKGROUND

指定默认的Material背景颜色。该值可以是任何颜色,或者是预定义的Material颜色之一,例如"Grey"

通用样式 特定环境变量:

变量

描述

QT_QUICK_CONTROLS_UNIVERSAL_THEME

指定默认的Universal theme。该值可以是可用的主题之一,例如"Dark"

QT_QUICK_CONTROLS_UNIVERSAL_ACCENT

指定默认的通用强调色。该值可以是任何颜色,但建议使用预定义的通用颜色之一,例如"Violet"

QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND

指定默认的Universal前景色。该值可以是任何颜色,或者是预定义的Universal颜色之一,例如"Brown"

QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND

指定默认的通用背景颜色。该值可以是任何颜色,或者是预定义的通用颜色之一,例如"Steel"